From 94e71b24d0b57824aa70431b46cd624121e5e0aa Mon Sep 17 00:00:00 2001 From: Rakhi Prathap Date: Thu, 18 Sep 2025 17:31:59 +0530 Subject: [PATCH 1/6] Add a common section --- .../n1ql-language-reference/datefun.adoc | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/modules/n1ql/pages/n1ql-language-reference/datefun.adoc b/modules/n1ql/pages/n1ql-language-reference/datefun.adoc index 63c197999..eda7eaa58 100644 --- a/modules/n1ql/pages/n1ql-language-reference/datefun.adoc +++ b/modules/n1ql/pages/n1ql-language-reference/datefun.adoc @@ -582,6 +582,30 @@ For example, `%Y %m %d` parses `2021-06-28`, `2021/06/28`, `2021.06.28`, and so -- ==== +In addition to the date formats listed above, {sqlpp} also accepts the following formats that's common to all styles: + + + +MONTH/Month/month - English month name in upper/mixed/lower case. + +MON/Mon/mon - Abbreviated English month name + +DAY/Day/day - English day name + +DY/Dy/dy - Abbreviated English day name + +AM/PM - synonyms for PP + +am/pm - synonyms for pp + +HH12 - synonym for HH + +HH24 - synonym for hh + +SS - synonym for ss + +MI - synonym for mm + [NOTE#default-values] .Default Values ==== From ff2ce71c94b0fb82dc5e35de064aed486bcb4fa1 Mon Sep 17 00:00:00 2001 From: Rakhi Prathap Date: Wed, 24 Sep 2025 15:37:51 +0530 Subject: [PATCH 2/6] Add new date formats --- .../n1ql-language-reference/datefun.adoc | 47 ++++++++++++++----- 1 file changed, 36 insertions(+), 11 deletions(-) diff --git a/modules/n1ql/pages/n1ql-language-reference/datefun.adoc b/modules/n1ql/pages/n1ql-language-reference/datefun.adoc index eda7eaa58..73d7087f0 100644 --- a/modules/n1ql/pages/n1ql-language-reference/datefun.adoc +++ b/modules/n1ql/pages/n1ql-language-reference/datefun.adoc @@ -582,29 +582,54 @@ For example, `%Y %m %d` parses `2021-06-28`, `2021/06/28`, `2021.06.28`, and so -- ==== -In addition to the date formats listed above, {sqlpp} also accepts the following formats that's common to all styles: +==== Common Date Formats +The following table lists common date formats used across all conventions: +[cols="1,2,2"] +|==== +| Format | Description | Example -MONTH/Month/month - English month name in upper/mixed/lower case. +| `MONTH` / `Month` / `month` +| Full English month name in uppercase, mixed case, or lowercase. +| `JANUARY` / `January` / `january` -MON/Mon/mon - Abbreviated English month name +| `MON` / `Mon` / `mon` +| Abbreviated English month name in uppercase, mixed case, or lowercase. +| `JAN` / `Jan` / `jan` -DAY/Day/day - English day name +| `DAY` / `Day` / `day` +| Full English day name in uppercase, mixed case, or lowercase. +| `MONDAY` / `Monday` / `monday` -DY/Dy/dy - Abbreviated English day name +| `DY` / `Dy` / `dy` +| Abbreviated English day name in uppercase, mixed case, or lowercase. +| `MON` / `Mon` / `mon` -AM/PM - synonyms for PP +| `AM` / `PM` +| Synonyms for `PP` (uppercase). +| `AM` / `PM` -am/pm - synonyms for pp +| `am` / `pm` +| Synonyms for `pp` (lowercase). +| `am` / `pm` -HH12 - synonym for HH +| `HH12` +| Synonym for `HH` (12-hour clock). +| `01` (1 AM) to `12` (12 PM) -HH24 - synonym for hh +| `HH24` +| Synonym for `hh` (24-hour clock). +| `00` (midnight) to `23` (11 PM) -SS - synonym for ss +| `SS` +| Synonym for `ss` (seconds). +| `00` to `59` -MI - synonym for mm +| `MI` +| Synonym for `mm` (minutes). +| `00` to `59` +|==== [NOTE#default-values] .Default Values From df7937e14739d8b5d682b6ab467aa9e60144ec0d Mon Sep 17 00:00:00 2001 From: Rakhi Prathap Date: Tue, 30 Sep 2025 12:02:09 +0530 Subject: [PATCH 3/6] New date formats --- .../n1ql-language-reference/datefun.adoc | 77 +++++++------------ 1 file changed, 26 insertions(+), 51 deletions(-) diff --git a/modules/n1ql/pages/n1ql-language-reference/datefun.adoc b/modules/n1ql/pages/n1ql-language-reference/datefun.adoc index 73d7087f0..9a02fc3e3 100644 --- a/modules/n1ql/pages/n1ql-language-reference/datefun.adoc +++ b/modules/n1ql/pages/n1ql-language-reference/datefun.adoc @@ -225,24 +225,48 @@ The date string codes are given below. | `MM` | 2-digit month +| `MONTH` / `Month` / `month` +| Full English month name in uppercase, mixed case, or lowercase + +| `MON` / `Mon` / `mon` +| Abbreviated English month name in uppercase, mixed case, or lowercase + | `DD` | 2-digit day +| `DAY` / `Day` / `day` +| Full English day name in uppercase, mixed case, or lowercase + +| `DY` / `Dy` / `dy` +| Abbreviated English day name in upper case, mixed case, or lower case + | `hh` | 2-digit hour, 00-23 | `HH` | 2-digit hour, 00-23 -| `mm` +| `HH12` +| 2-digit hour, 01-12 + +| `HH24` +| 2-digit hour, 00-23 + +| `mm` / `MI` | 2-digit minute, 00-59 -| `ss` +| `ss` / `SS` | 2-digit second, 00-59 | `s` | Fraction of a second (down to millisecond) -- output only +| `AM` / `PM` +| AM or PM (upper case) + +| `am` / `pm` +| am or pm (lower case) + | `TZD` | Time Zone (as UTC offset) |==== @@ -582,55 +606,6 @@ For example, `%Y %m %d` parses `2021-06-28`, `2021/06/28`, `2021.06.28`, and so -- ==== -==== Common Date Formats - -The following table lists common date formats used across all conventions: - -[cols="1,2,2"] -|==== -| Format | Description | Example - -| `MONTH` / `Month` / `month` -| Full English month name in uppercase, mixed case, or lowercase. -| `JANUARY` / `January` / `january` - -| `MON` / `Mon` / `mon` -| Abbreviated English month name in uppercase, mixed case, or lowercase. -| `JAN` / `Jan` / `jan` - -| `DAY` / `Day` / `day` -| Full English day name in uppercase, mixed case, or lowercase. -| `MONDAY` / `Monday` / `monday` - -| `DY` / `Dy` / `dy` -| Abbreviated English day name in uppercase, mixed case, or lowercase. -| `MON` / `Mon` / `mon` - -| `AM` / `PM` -| Synonyms for `PP` (uppercase). -| `AM` / `PM` - -| `am` / `pm` -| Synonyms for `pp` (lowercase). -| `am` / `pm` - -| `HH12` -| Synonym for `HH` (12-hour clock). -| `01` (1 AM) to `12` (12 PM) - -| `HH24` -| Synonym for `hh` (24-hour clock). -| `00` (midnight) to `23` (11 PM) - -| `SS` -| Synonym for `ss` (seconds). -| `00` to `59` - -| `MI` -| Synonym for `mm` (minutes). -| `00` to `59` -|==== - [NOTE#default-values] .Default Values ==== From a9705a1fbd122b0e73111675cb70f2ef36f69716 Mon Sep 17 00:00:00 2001 From: Rakhi Prathap Date: Tue, 30 Sep 2025 12:05:19 +0530 Subject: [PATCH 4/6] New date formats --- modules/n1ql/pages/n1ql-language-reference/datefun.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/n1ql/pages/n1ql-language-reference/datefun.adoc b/modules/n1ql/pages/n1ql-language-reference/datefun.adoc index 9a02fc3e3..faffbcb7b 100644 --- a/modules/n1ql/pages/n1ql-language-reference/datefun.adoc +++ b/modules/n1ql/pages/n1ql-language-reference/datefun.adoc @@ -238,7 +238,7 @@ The date string codes are given below. | Full English day name in uppercase, mixed case, or lowercase | `DY` / `Dy` / `dy` -| Abbreviated English day name in upper case, mixed case, or lower case +| Abbreviated English day name in uppercase, mixed case, or lowercase | `hh` | 2-digit hour, 00-23 From a9eb3597c60e4222ecacd45367f2b03505b41ed7 Mon Sep 17 00:00:00 2001 From: Rakhi Prathap Date: Tue, 30 Sep 2025 12:18:21 +0530 Subject: [PATCH 5/6] fix typo --- modules/n1ql/pages/n1ql-language-reference/datefun.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/n1ql/pages/n1ql-language-reference/datefun.adoc b/modules/n1ql/pages/n1ql-language-reference/datefun.adoc index faffbcb7b..1bfa0da8a 100644 --- a/modules/n1ql/pages/n1ql-language-reference/datefun.adoc +++ b/modules/n1ql/pages/n1ql-language-reference/datefun.adoc @@ -262,10 +262,10 @@ The date string codes are given below. | Fraction of a second (down to millisecond) -- output only | `AM` / `PM` -| AM or PM (upper case) +| AM or PM (uppercase) | `am` / `pm` -| am or pm (lower case) +| am or pm (lowercase) | `TZD` | Time Zone (as UTC offset) From 3b6867e7cd1ce711cf985a983360bc7497d82d30 Mon Sep 17 00:00:00 2001 From: Rakhi Prathap Date: Tue, 30 Sep 2025 13:57:25 +0530 Subject: [PATCH 6/6] Add another code --- modules/n1ql/pages/n1ql-language-reference/datefun.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/n1ql/pages/n1ql-language-reference/datefun.adoc b/modules/n1ql/pages/n1ql-language-reference/datefun.adoc index 1bfa0da8a..27e487c2b 100644 --- a/modules/n1ql/pages/n1ql-language-reference/datefun.adoc +++ b/modules/n1ql/pages/n1ql-language-reference/datefun.adoc @@ -261,10 +261,10 @@ The date string codes are given below. | `s` | Fraction of a second (down to millisecond) -- output only -| `AM` / `PM` +| `AM` / `PM` / `PP` | AM or PM (uppercase) -| `am` / `pm` +| `am` / `pm` / `pp` | am or pm (lowercase) | `TZD`