From 155cd5e6b5f4c787ce01369d0187431c71a0d909 Mon Sep 17 00:00:00 2001
From: Andrew Mutz <andrew.mutz@gmail.com>
Date: Mon, 14 May 2012 17:47:55 -0700
Subject: Moving NumberHelpers from ActionView to ActiveSupport

---
 .../source/active_support_core_extensions.textile  | 70 ++++++++++++++++++++++
 1 file changed, 70 insertions(+)

(limited to 'guides/source/active_support_core_extensions.textile')

diff --git a/guides/source/active_support_core_extensions.textile b/guides/source/active_support_core_extensions.textile
index 587f65529e..2addc50d68 100644
--- a/guides/source/active_support_core_extensions.textile
+++ b/guides/source/active_support_core_extensions.textile
@@ -1840,6 +1840,76 @@ date and time arithmetic.
 
 NOTE: Defined in +active_support/core_ext/numeric/time.rb+.
 
+h4. Formatting
+
+Enables the formatting of numbers in a variety of ways.
+
+Produce a string representation of a number as a telephone number:
+<ruby>
+5551234.to_s(:phone)                                           # => 555-1234
+1235551234.to_s(:phone)                                        # => 123-555-1234
+1235551234.to_s(:phone, :area_code => true)                    # => (123) 555-1234
+1235551234.to_s(:phone, :delimiter => " ")                     # => 123 555 1234
+1235551234.to_s(:phone, :area_code => true, :extension => 555) # => (123) 555-1234 x 555
+1235551234.to_s(:phone, :country_code => 1)                    # => +1-123-555-1234
+</ruby>
+
+Produce a string representation of a number as currency:
+<ruby>
+1234567890.50.to_s(:currency)                    # => $1,234,567,890.50
+1234567890.506.to_s(:currency)                   # => $1,234,567,890.51
+1234567890.506.to_s(:currency, :precision => 3)  # => $1,234,567,890.506
+</ruby>
+
+Produce a string representation of a number as a percentage:
+<ruby>
+100.to_s(:percentage)                                        # => 100.000%
+100.to_s(:percentage, :precision => 0)                       # => 100%
+1000.to_s(:percentage, :delimiter => '.', :separator => ',') # => 1.000,000%
+302.24398923423.to_s(:percentage, :precision => 5)           # => 302.24399%
+</ruby>
+
+Produce a string representation of a number in delimited form:
+<ruby>
+12345678.to_s(:delimited)                        # => 12,345,678
+12345678.05.to_s(:delimited)                     # => 12,345,678.05
+12345678.to_s(:delimited, :delimiter => ".")     # => 12.345.678
+12345678.to_s(:delimited, :delimiter => ",")     # => 12,345,678
+12345678.05.to_s(:delimited, :separator => " ")  # => 12,345,678 05
+</ruby>
+
+Produce a string representation of a number rounded to a precision:
+<ruby>
+111.2345.to_s(:rounded)                                            # => 111.235
+111.2345.to_s(:rounded, :precision => 2)                           # => 111.23
+13.to_s(:rounded, :precision => 5)                                 # => 13.00000
+389.32314.to_s(:rounded, :precision => 0)                          # => 389
+111.2345.to_s(:rounded, :significant => true)                      # => 111
+</ruby>
+
+Produce a string representation of a number as a human-readable number of bytes:
+<ruby>
+123.to_s(:human_size)                                          # => 123 Bytes
+1234.to_s(:human_size)                                         # => 1.21 KB
+12345.to_s(:human_size)                                        # => 12.1 KB
+1234567.to_s(:human_size)                                      # => 1.18 MB
+1234567890.to_s(:human_size)                                   # => 1.15 GB
+1234567890123.to_s(:human_size)                                # => 1.12 TB
+</ruby>
+
+Produce a string representation of a number in human-readable words:
+<ruby>
+123.to_s(:human)                                          # => "123"
+1234.to_s(:human)                                         # => "1.23 Thousand"
+12345.to_s(:human)                                        # => "12.3 Thousand"
+1234567.to_s(:human)                                      # => "1.23 Million"
+1234567890.to_s(:human)                                   # => "1.23 Billion"
+1234567890123.to_s(:human)                                # => "1.23 Trillion"
+1234567890123456.to_s(:human)                             # => "1.23 Quadrillion"
+</ruby>
+
+NOTE: Defined in +active_support/core_ext/numeric/formatting.rb+.
+
 h3. Extensions to +Integer+
 
 h4. +multiple_of?+
-- 
cgit v1.2.3

