Contents

# frozen_string_literal: true

#
# Copyright (c) 2020-present, Blue Marble Payroll, LLC
#
# This source code is licensed under the MIT license found in the
# LICENSE file in the root directory of this source tree.
#

module Realize
  class Format
    # Formats a date/time value.  If the input is nil, it will output nil.  If an input_format
    # is configured then it will use that to explicitly parse it.  If an input_format is not
    # specified then it will use Ruby's DateTime#parse heuristics for parsing.  By default,
    # the output format is ISO-8601 standard (YYYY-MM-DD).  It is also possible to have
    # this output formatted time as well, but since it is named 'format_date', it is assumed
    # you want something date-only.
    #
    # See this link for more information about Ruby's DateTime parsing and formatting
    # details and also for valid format tokens:
    # https://ruby-doc.org/stdlib-2.6.6/libdoc/date/rdoc/DateTime.html#method-i-strftime
    class Date
      acts_as_hashable

      OUTPUT_FORMAT = '%F'

      attr_reader :input_format, :output_format

      def initialize(input_format: '', output_format: OUTPUT_FORMAT)
        @input_format  = input_format.to_s
        @output_format = output_format.to_s

        freeze
      end

      def transform(_resolver, value, _time, _record)
        return nil if value.to_s.empty?

        date_time =
          if input_format?
            DateTime.strptime(value, input_format)
          else
            DateTime.parse(value.to_s)
          end

        date_time.strftime(output_format)
      end

      private

      def input_format?
        input_format.length.positive?
      end
    end
  end
end

Version data entries

3 entries across 3 versions & 1 rubygems

Version	Path
realize-1.6.0	lib/realize/format/date.rb
realize-1.5.0	lib/realize/format/date.rb
realize-1.4.0	lib/realize/format/date.rb