num2words 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 83b33cb28c58663786a3033b2aefceb7e0478d49d40b1db5b1bee5bc63f0198b
-  data.tar.gz: 5293c916f1a5ad2726662cb5973033b23fa5f9b703920b2b4be21f293d47d67e
+  metadata.gz: 1809289bec98157e0b78b8bbe9f18b5fab8fa5f111293105e89b5747d866e43d
+  data.tar.gz: 1e5cfdd50831c7e9f75a8216488268564cda27b7972c70feca0a9d34c05c907b
 SHA512:
-  metadata.gz: c498c97a62099658e43c6d29159b9c6fc5c8d3113e19fdc0fe774966dbacce7084d8e0e5293e1a9b1b9cad5b0441af1ae35efe1922441a19196fd49f0d771756
-  data.tar.gz: 53ceaa5a779dd1e7c3e8308d4f21dcafe2a3cde1a775ddb68fb7497be605d551497ee22350c3309feb4f21c648ff9546761c427ff5839ae43e0c01f073febc08
+  metadata.gz: 353353c876466e244bf2748073d7a3534a5ead257bc8d7f70f35d975a45762f4d2e0023d2cbf6e55136587974278093987fd2bba4d20ec972f33bedc9a1820c2
+  data.tar.gz: 8037de95f9896db0f4b00aa16710836de2337416c646dfc40900f3021a019aba9c04ae7f06842ebc6be73904aca9156258ee766992a861196a3274008ca13ab4

data/CHANGELOG.md

@@ -15,6 +15,33 @@
 
 ---
 
+## [0.1.4] - 2025-08-21
+### Added
+- Расширение `String#to_words`, возможность преобразовать строки с датами
+```ruby
+"21.08.2025".to_words(:ru)
+# => "двадцать первое августа две тысячи двадцать пятого года"
+
+"21.08.2025".to_words(:en)
+# => "the twenty-first of August, two thousand twenty five" 
+```
+- Расширение `Date#to_words`, добавлена возможность преобразовывать объекты Date и DateTime
+```ruby
+Date.new(2025, 8, 21).to_words(:ru)
+# => "двадцать первого августа две тысячи двадцать пятого года"
+
+Date.new(2025, 8, 21).to_words(:en)
+# => "the twenty-first of August, two thousand twenty-five"
+```
+- Поддержка параметра `format: :nominative`, можно получать даты в именительном падеже.
+```ruby
+Date.new(2025, 8, 21).to_words(:ru, format: :nominative)
+# => "двадцать первое августа две тысячи двадцать пятый год"
+
+"19.07.2012".to_words(:ru, format: :nominative)
+# => "девятнадцатое июля две тысячи двенадцатый год"
+```
+
 ## [0.1.3] – 2025-08-20
 ### Added
 - Параметр **`word_case:`** для методов `to_words`, `to_currency` со значениями:

data/config/locales/en.yml

@@ -39,3 +39,17 @@ en:
       10000000: ["ten-millionth", "ten-millionths", "ten-millionths"]
       100000000: ["hundred-millionth", "hundred-millionths", "hundred-millionths"]
       1000000000: ["billionth", "billionths", "billionths"]
+
+    date:
+      template:
+        default: "the %{day} of %{month}, %{year}"
+      months:
+        default: ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"]
+
+    numbers:
+      ordinals:
+        default:
+          masculine: ["first", "second", "third", "fourth", "fifth", "sixth", "seventh", "eighth", "ninth",
+                      "tenth", "eleventh", "twelfth", "thirteenth", "fourteenth" ,"fifteenth", "sixteenth", "seventeenth", "eighteenth", "nineteenth",
+                      "twentieth", "twenty-first", "twenty-second", "twenty-third", "twenty-fourth", "twenty-fifth", "twenty-sixth", "twenty-seventh", "twenty-eighth", "twenty-ninth",
+                      "thirtieth","thirty-first"]

data/config/locales/ru.yml

@@ -34,3 +34,32 @@ ru:
       10000000: ["десятимиллионная", "десятимиллионные", "десятимиллионных"]
       100000000: ["стомиллионная", "стомиллионные", "стомиллионных"]
       1000000000: ["миллиардная", "миллиардные", "миллиардных"]
+
+    date:
+      template:
+        default: "%{day} %{month} %{year} года"
+        nominative: "%{day} %{month} %{year} год"
+      months:
+        default: ["января", "февраля", "марта", "апреля", "мая", "июня", "июля", "августа", "сентября", "октября", "ноября", "декабря"]
+        nominative: ["января", "февраля", "марта", "апреля", "мая", "июня", "июля", "августа", "сентября", "октября", "ноября", "декабря"]
+
+    numbers:
+      ordinals:
+        nominative:
+          masculine: ["первый", "второй", "третий", "четвёртый", "пятый", "шестой", "седьмой", "восьмой", "девятый", "десятый",
+                      "одиннадцатый", "двенадцатый", "тринадцатый", "четырнадцатый", "пятнадцатый", "шестнадцатый", "семнадцатый", "восемнадцатый", "девятнадцатый",
+                      "двадцатый", "двадцать первый", "двадцать второй", "двадцать третий", "двадцать четвёртый", "двадцать пятый", "двадцать шестой", "двадцать седьмой", "двадцать восьмой", "двадцать девятый",
+                      "тридцатый", "тридцать первый"]
+          feminine: ["первая", "вторая", "третья", "четвёртая", "пятая", "шестая", "седьмая", "восьмая", "девятая",
+                     "десятая", "одиннадцатая", "двенадцатая", "тринадцатая", "четырнадцатая", "пятнадцатая", "шестнадцатая", "семнадцатая", "восемнадцатая", "девятнадцатая",
+                     "двадцатая", "двадцать первая", "двадцать вторая", "двадцать третья", "двадцать четвёртая", "двадцать пятая", "двадцать шестая", "двадцать седьмая", "двадцать восьмая", "двадцать девятая",
+                     "тридцатая", "тридцать первая"]
+          neuter: ["первое", "второе", "третье", "четвёртое", "пятое", "шестое", "седьмое", "восьмое", "девятое",
+                   "десятое", "одиннадцатое", "двенадцатое", "тринадцатое", "четырнадцатое", "пятнадцатое", "шестнадцатое", "семнадцатое", "восемнадцатое", "девятнадцатое",
+                   "двадцатое", "двадцать первое", "двадцать второе", "двадцать третье", "двадцать четвёртое", "двадцать пятое", "двадцать шестое", "двадцать седьмое", "двадцать восьмое", "двадцать девятое",
+                   "тридцатое", "тридцать первое"]
+        default:
+          masculine: ["первого", "второго", "третьего", "четвёртого", "пятого", "шестого", "седьмого", "восьмого", "девятого",
+                      "десятого", "одиннадцатого", "двенадцатого", "тринадцатого", "четырнадцатого", "пятнадцатого", "шестнадцатого", "семнадцатого", "восемнадцатого", "девятнадцатого",
+                      "двадцатого", "двадцать первого", "двадцать второго", "двадцать третьего", "двадцать четвёртого", "двадцать пятого", "двадцать шестого", "двадцать седьмого", "двадцать восьмого", "двадцать девятого",
+                      "тридцатого", "тридцать первого"]

data/lib/num2words/converter.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "date"
+
 module Num2words
   class Converter
     class << self
@@ -7,15 +9,19 @@ module Num2words
         locale    = args.first.is_a?(Symbol) ? args.first : opts[:locale] || I18n.default_locale
         feminine  = opts[:feminine] || false
         style     = opts[:style] || :fraction
-        word_case = opts[:word_case] || :downcase
+        word_case = opts[:word_case] || :default
+        date_format = opts[:format] || :default
         locale_data = Locales[locale]
 
-        result = if number.is_a?(Float)
-                   to_words_fractional(number, locale, feminine, locale_data, style: style)
-                 else
-                   to_words_integer(number, locale, feminine, locale_data)
+        result = case detect_type(number)
+                 when :float then to_words_fractional(number, locale, feminine, locale_data, style: style)
+                 when :integer then to_words_integer(number, locale, feminine, locale_data)
+                 when :date then to_words_date(number, locale, locale_data, format: date_format)
+                 else nil
                  end
 
+        raise ArgumentError, "Unsupported input type: #{number.inspect}" if result.nil?
+
         apply_case(result, word_case)
       end
 
@@ -123,6 +129,47 @@ module Num2words
         words.join(" ")
       end
 
+      def to_words_date(date, locale, locale_data, format: :default)
+        date = Date.parse(date.to_s) unless date.is_a?(Date)
+
+        day, month, year = [date.day, date.month, date.year]
+
+        months = locale_data::DATE[:months][format] || locale_data::DATE[:months][:default]
+        template = locale_data::TEMPLATE[format] || locale_data::TEMPLATE[:default]
+
+        raise ArgumentError, "Months not found for locale #{locale}" unless months
+        raise ArgumentError, "Template not found for locale #{locale}" unless template
+
+        day_words   = to_words_ordinal(day, locale, format, locale_data, gender: :neuter)
+        month_words = months[month - 1]
+        year_words  = to_words_ordinal(year, locale, format, locale_data)
+
+        template % { day: day_words, month: month_words, year: year_words }
+      end
+
+      def to_words_ordinal(value, locale, format, locale_data, gender: :masculine)
+        ordinals = locale_data::ORDINALS[format] rescue nil
+        raise ArgumentError, "Ordinals not found for locale #{locale}, format #{format}" unless ordinals
+
+        gender_data = ordinals[gender] || ordinals[:masculine]
+        raise ArgumentError, "Gender #{gender} not found for locale #{locale}, format #{format}" unless gender_data
+
+        return gender_data[value - 1] if gender_data[value]
+
+        if value > 31
+          thousands = (value / 100) * 100
+          last_two  = value % 100
+
+          base_year   = to_words_integer(thousands, locale, false, locale_data)
+          last_ordinal = gender_data[last_two - 1] || to_words_integer(last_two, locale, false, locale_data)
+          last_ordinal = to_words_integer(last_two, locale, false, locale_data) if locale == :en
+
+          return [base_year, last_ordinal].join(" ")
+        end
+
+        to_words_integer(value, locale, false, locale_data)
+      end
+
       def apply_case(text, word_case)
         case word_case
         when :upper then text.upcase
@@ -132,6 +179,25 @@ module Num2words
         else text
         end
       end
+
+      def detect_type(value)
+        case value
+        when Integer then :integer
+        when Float then :float
+        when Date, Time, ::DateTime then :date
+        when String
+          return :integer if /\A-?\d+\z/.match?(value)
+          return :float if /\A-?\d+\.\d+\z/.match?(value)
+
+          begin
+            Date.parse(value)
+            :date
+          rescue ArgumentError
+            :string
+          end
+        else :unknown
+        end
+      end
     end
   end
 end

data/lib/num2words/core_ext.rb

@@ -19,3 +19,15 @@ class Float
     Num2words::Converter.to_currency(self, *args, **opts)
   end
 end
+
+class String
+  def to_words(*args, **opts)
+    Num2words::Converter.to_words(self, *args, **opts)
+  end
+end
+
+class Date
+  def to_words(*args, **opts)
+    Num2words::Converter.to_words(self.strftime("%d.%m.%Y"), *args, **opts)
+  end
+end

data/lib/num2words/locales/en.rb

@@ -15,6 +15,11 @@ module Num2words
 
       FRACTIONS = I18n.t("num2words.fractions", locale: :en)
       GRAMMAR = I18n.t("num2words.grammar", locale: :en)
+
+      DATE = I18n.t("num2words.date", locale: :en)
+      TEMPLATE = I18n.t("num2words.date.template", locale: :en)
+
+      ORDINALS = I18n.t("num2words.numbers.ordinals", locale: :en)
     end
 
     register :en, EN

data/lib/num2words/locales/ru.rb

@@ -15,6 +15,11 @@ module Num2words
 
       FRACTIONS = I18n.t("num2words.fractions", locale: :ru)
       GRAMMAR = I18n.t("num2words.grammar", locale: :ru)
+
+      DATE = I18n.t("num2words.date", locale: :ru)
+      TEMPLATE = I18n.t("num2words.date.template", locale: :ru)
+
+      ORDINALS = I18n.t("num2words.numbers.ordinals", locale: :ru)
     end
 
     register :ru, RU

data/lib/num2words/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Num2words
-  VERSION = "0.1.3"
+  VERSION = "0.1.4"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: num2words
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Ruslan Fedotov
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-08-20 00:00:00.000000000 Z
+date: 2025-08-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: i18n