From e187ad8bf849a88f868a537ac16cf78f4c35bde5 Mon Sep 17 00:00:00 2001
From: campbellcole <10430178+campbellcole@users.noreply.github.com>
Date: Sat, 6 May 2023 21:26:21 -0700
Subject: [PATCH] add documentation for %Z quirk
---
src/format/strftime.rs | 8 +++++++-
1 file changed, 7 insertions(+), 1 deletion(-)
diff --git a/src/format/strftime.rs b/src/format/strftime.rs
index 5a113fa43c..24bae20c0a 100644
--- a/src/format/strftime.rs
+++ b/src/format/strftime.rs
@@ -68,7 +68,7 @@ The following specifiers are available both to formatting and parsing.
| `%r` | `12:34:60 AM` | Hour-minute-second format in 12-hour clocks. Same as `%I:%M:%S %p`. |
| | | |
| | | **TIME ZONE SPECIFIERS:** |
-| `%Z` | `ACST` | Local time zone name. Skips all non-whitespace characters during parsing. [^8] |
+| `%Z` | `ACST` | Local time zone name. Skips all non-whitespace characters during parsing. Identical to `%:z` when formatting. [^8] |
| `%z` | `+0930` | Offset from the local time to UTC (with UTC being `+0000`). |
| `%:z` | `+09:30` | Same as `%z` but with a colon. |
|`%::z`|`+09:30:00`| Offset from the local time to UTC with seconds. |
@@ -164,6 +164,12 @@ Notes:
Note that they can read nothing if the fractional part is zero.
[^8]: `%Z`:
+ Since `chrono` is not aware of timezones beyond their offsets, this specifier
+ **only prints the offset** when used for formatting. The timezone abbreviation
+ will NOT be printed. See [this issue](https://github.com/chronotope/chrono/issues/960)
+ for more information.
+
+
Offset will not be populated from the parsed data, nor will it be validated.
Timezone is completely ignored. Similar to the glibc `strptime` treatment of
this format code.