Module: Num2words::Locales::EN

Defined in:
lib/num2words/locales/en.rb

Constant Summary collapse

ONES_MASC = 
I18n.t("num2words.ones_masc", locale: :en)
ONES_FEM = 
I18n.t("num2words.ones_fem", locale: :en)
TEENS = 
I18n.t("num2words.teens", locale: :en)
TENS = 
I18n.t("num2words.tens", locale: :en)
HUNDREDS = 
I18n.t("num2words.hundreds", locale: :en)
SCALES = 
I18n.t("num2words.scales", locale: :en)
FRACTIONS = 
I18n.t("num2words.fractions", locale: :en)
GRAMMAR = 
I18n.t("num2words.grammar", locale: :en)
DATE = 
I18n.t("num2words.date", locale: :en)
DATE_TEMPLATE = 
I18n.t("num2words.date.template", locale: :en)
TIME = 
I18n.t("num2words.time", locale: :en)
TIME_TEMPLATE = 
I18n.t("num2words.time.template", locale: :en)
DATETIME_TEMPLATE = 
I18n.t("num2words.datetime.template", locale: :en)
ORDINALS = 
I18n.t("num2words.numbers.ordinals", locale: :en)

Class Method Summary collapse

Class Method Details

.cardinal(number, feminine: false) ⇒ Object 



89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
 
# File 'lib/num2words/locales/en.rb', line 89

def cardinal(number, feminine: false)
  integer_value = Integer(number)
  negative = integer_value.negative?
  integer_value = integer_value.abs

  return (feminine ? ONES_FEM[0] : ONES_MASC[0]) if integer_value.zero?

  groups = integer_value.to_s
                        .chars.reverse.each_slice(3).map(&:reverse)
                        .map(&:join).map!(&:to_i).reverse

  words = []
  groups.each_with_index do |group_value, index|
    scale_idx = groups.size - index - 1
    words.concat triple_to_words(group_value, scale_idx, feminine: feminine)
  end

  words.unshift(minus_word) if negative
  words.join(" ")
end

.date_day(day, format:, date_case:) ⇒ Object 



72
73
74
 
# File 'lib/num2words/locales/en.rb', line 72

def date_day(day, format:, date_case:)
  ordinal(day, format)
end

.date_year(year, format:) ⇒ Object 



76
77
78
 
# File 'lib/num2words/locales/en.rb', line 76

def date_year(year, format:)
  cardinal(year)
end

.decimal_fraction_words(fraction_string) ⇒ Object 



50
51
52
 
# File 'lib/num2words/locales/en.rb', line 50

def decimal_fraction_words(fraction_string)
  fraction_string.chars.map { |digit| cardinal(digit.to_i) }.join(" ")
end

.decimal_separator_word ⇒ Object 



46
47
48
 
# File 'lib/num2words/locales/en.rb', line 46

def decimal_separator_word
  "point"
end

.default_fraction_word ⇒ Object 



42
43
44
 
# File 'lib/num2words/locales/en.rb', line 42

def default_fraction_word
  GRAMMAR[:default_fraction]
end

.feminine_group?(_scale_idx) ⇒ Boolean

Returns:

  • (Boolean) 


26
27
28
 
# File 'lib/num2words/locales/en.rb', line 26

def feminine_group?(_scale_idx)
  false
end

.fraction_joiner(_joiner) ⇒ Object 



38
39
40
 
# File 'lib/num2words/locales/en.rb', line 38

def fraction_joiner(_joiner)
  GRAMMAR[:conjunction]
end

.fraction_numerator_feminine? ⇒ Boolean

Returns:

  • (Boolean) 


30
31
32
 
# File 'lib/num2words/locales/en.rb', line 30

def fraction_numerator_feminine?
  false
end

.minus_word ⇒ Object 



34
35
36
 
# File 'lib/num2words/locales/en.rb', line 34

def minus_word
  GRAMMAR[:minus]
end

.ordinal(value, format, gender: :masculine) ⇒ Object 



80
81
82
83
84
85
86
87
 
# File 'lib/num2words/locales/en.rb', line 80

def ordinal(value, format, gender: :masculine)
  ordinals = ORDINALS[format]
  gender_data = ordinals[gender] || ordinals[:masculine]

  return gender_data[value - 1] if value.between?(1, gender_data.length)

  cardinal(value)
end

.pluralize(number, singular, few, plural) ⇒ Object 



110
111
112
 
# File 'lib/num2words/locales/en.rb', line 110

def pluralize(number, singular, few, plural)
  number.abs == 1 ? singular : plural
end

.triple_to_words(number, scale_idx, feminine: false) ⇒ Object 



54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
 
# File 'lib/num2words/locales/en.rb', line 54

def triple_to_words(number, scale_idx, feminine: false)
  words = []

  words << HUNDREDS[number / 100] if number >= 100
  rest = number % 100

  if rest.between?(10, 19)
    words << TEENS[rest - 10]
  else
    words << TENS[rest / 10] if rest >= 20
    ones = rest % 10
    words << (feminine ? ONES_FEM[ones] : ONES_MASC[ones]) if ones.positive?
  end

  words << pluralize(number, *SCALES[scale_idx]) unless scale_idx.zero?
  words.compact
end