summaryrefslogtreecommitdiffstats
path: root/user_guide_src/source
diff options
context:
space:
mode:
authorAndrey Andreev <narf@devilix.net>2016-10-21 17:04:12 +0200
committerGitHub <noreply@github.com>2016-10-21 17:04:12 +0200
commit4de4f4c88ea49db3867882f21b727e953ca1a590 (patch)
tree3c1bf5eab322ca05088be8cbed2e5aa3d9362352 /user_guide_src/source
parent5d05372f4f59d27fdd93249d813970fcf181a4af (diff)
parent25dc0937dd27c6d3c9f4d4483a857c218d6a9dad (diff)
Merge pull request #4862 from gxgpet/remote-develop
New function for Inflector helper: ordinal_format()
Diffstat (limited to 'user_guide_src/source')
-rw-r--r--user_guide_src/source/helpers/inflector_helper.rst18
1 files changed, 17 insertions, 1 deletions
diff --git a/user_guide_src/source/helpers/inflector_helper.rst b/user_guide_src/source/helpers/inflector_helper.rst
index df0c568c0..76cce6f4d 100644
--- a/user_guide_src/source/helpers/inflector_helper.rst
+++ b/user_guide_src/source/helpers/inflector_helper.rst
@@ -93,4 +93,20 @@ The following functions are available:
Checks if the given word has a plural version. Example::
- is_countable('equipment'); // Returns FALSE \ No newline at end of file
+ is_countable('equipment'); // Returns FALSE
+
+.. php:function:: ordinal_format($number)
+
+ :param int $number: non-negative natural number to be converted
+ :returns: Ordinal numeral for given number or original value on failure
+ :rtype: string
+
+ Returns the ordinal numeral (1st, 2nd, 3rd etc.) for a
+ non-negative natural number. If the input is not a natural number
+ greater than 0, the function will return the original value. Examples::
+
+ echo ordinal_format(1); // Returns 1st
+ echo ordinal_format(3); // Returns 3rd
+ echo ordinal_format(21); // Returns 21st
+ echo ordinal_format(102); // Returns 102nd
+ echo ordinal_format(-5); // Invalid input, will return -5