nicer considerations block

Author: rsill-neo4j

modules/ROOT/pages/functions/temporal/format.adoc

@@ -74,83 +74,94 @@ Most characters change yield a different output when they are repeated.
 |===
 
 .Considerations
-|===
-
-| Some characters cannot be applied to certain types, for instance, `u` cannot be used to construct a string for a `LOCAL TIME` because it represents a year which is not part of the temporal value.
-
-| The "text" presentation is determined by how often the pattern character is repeated: less than 4 characters result in the short form ("AD"). Exactly 4 characters result in the full form ("Anno Domini"). Exactly 5 characters result in the narrow form ("A").
+[caption=""]
+======
 
-The characters 'L', 'q', and 'c' represent the standalone form of the text presentation.
+* Some characters cannot be applied to certain types, for instance, `u` cannot be used to construct a string for a `LOCAL TIME` because it represents a year which is not part of the temporal value.
 
-| A single "number" character outputs the minimum number of digits without padding. With more "number" characters, the number of digits is used as the width of the output field, with the value zero-padded as necessary.
+* The **text** presentation is determined by how often the pattern character is repeated: less than 4 characters result in the short form ("AD"). Exactly 4 characters result in the full form ("Anno Domini"). Exactly 5 characters result in the narrow form ("A").
++
+The characters `L`, `q`, and `c` represent the standalone form of the text presentation.
 
+* A single **number** character outputs the minimum number of digits without padding. With more **number** characters, the number of digits is used as the width of the output field, with the value zero-padded as necessary.
++
 The following characters have constraints on the count of letters:
++
+Only a single `c` or `F` can be specified.
++
+Up to two `d`, `H`, `h`, `K`, `k`, `m`, and `s` can be specified.
++
+Up to three `D` can be specified.
 
-Only one letter of 'c' and 'F' can be specified.
-
-Up to two letters of 'd', 'H', 'h', 'K', 'k', 'm', and 's' can be specified.
-
-Up to three letters of 'D' can be specified.
-
-| If the number of characters in a "number/text" is 3 or greater, use the text rules, otherwise the number rules.
-
-| A "fraction" outputs the nano-of-second field as a fraction-of-second. The nano-of-second value has nine digits, thus the number of characters can be between 1 and 9 and is truncated if it is less than 9.
+* If the number of characters in a **number/text** is three or greater, use the text rules, otherwise the number rules.
 
-| The "year" characters determine the minimum field width below which padding is used.
+* A **fraction** outputs the nano-of-second field as a fraction-of-second.
+The nano-of-second value has nine digits, thus the number of characters can be between 1 and 9 and is truncated if it is less than 9.
 
+* The **year** characters determine the minimum field width below which padding is used.
++
 With two characters, the reduced two digit form is used. For printing, this outputs the rightmost two digits. For parsing, this will use the base value of 2000, resulting in a year within the range of 2000 and 2099.
-
++
 With one or three characters, the minus-sign is only output for negative years. Otherwise, the minus-sign is output if the pad width is exceeded.
 
-| A "zone-id" outputs the timezone ID. Two characters output the timezone ID, other amounts result in an error.
-
-| A "zone-name" outputs the display name of the timezone ID.
-
-If the pattern character is 'z', the output is the daylight saving time (DST) zone name. If there is insufficient information to determine whether DST applies, the name ignoring daylight saving time will be used.One, two or three characters output the short name, four characters output the full name, and five or more result in an error.
-
-If the character is 'v', the output provides the zone name ignoring daylight saving time.
-One 'v' outputs the short name, two three and five result in an error, and four 'v's output the full name.
-
-| "offset-X" and "offset-x" format the offset based on the number of pattern characters.
-One character outputs just the hour, such as '+01', unless the minute is non-zero. In that case, the minute is also output, such as '+0130'.
-
-Two characters output the hour and minute, without a colon, such as '+0130'.
-
-Three characters output the hour and minute, with a colon, such as '+01:30'.
-
-Four letters outputs the hour and minute and optional second, without a colon, such as '+013015'.
-
-Five letters outputs the hour and minute and optional second, with a colon, such as '+01:30:15'. 
-
-Six or more letters result in an error.
-
-An upper case 'X' outputs 'Z' if the offset would be zero, whereas a lowwer case 'x'  outputs '+00', '+0000', or '+00:00'.
-
-| With a non-zero offset, "offset-O" formats the localized offset based on the number of characters.
-
-One character outputs the short form of the localized offset, which is the localized offset text, such as 'GMT', followed by the hour without leading zero, optional 2-digit minute and second if they are non-zero, and a colon, for example 'GMT+8'.
-
-Four characters output the full form, which is a localized offset text, such as 'GMT, with a 2-digit hour and minute field, optional second field if non-zero, and colon, for example 'GMT+08:00'.
-
-If the offset is zero, only localized text is output.
-
+* A **zone-id** outputs the timezone ID. Two characters output the timezone ID, other amounts result in an error.
+
+* A **zone-name** outputs the display name of the timezone ID.
++
+If the pattern character is `z`, the output is the daylight saving time (DST) zone name.
+If there is insufficient information to determine whether DST applies, the name ignoring daylight saving time will be used.
++
+One, two or three characters output the short name, four characters output the full name, and five or more result in an error.
++
+If the character is `v`, the output provides the zone name ignoring daylight saving time.
+One `v` outputs the short name, two three and five result in an error, and four `v` output the full name.
+
+* **offset-X** and **offset-x** format the offset based on the number of pattern characters.
+One character outputs just the hour, like `+01`, unless the minute is non-zero.
+In that case, the minute is also output, like `+0130`.
++
+Two characters output the hour and minute, without a colon, like `+0130`.
++
+Three characters output the hour and minute, with a colon, like `+01:30`.
++
+Four characters output the hour and minute and optional second, without a colon, like `+013015`.
++
+Five characters output the hour and minute and optional second, with a colon, like `+01:30:15`. 
++
+Six or more characters result in an error.
++
+An upper case `X` outputs `Z` if the offset is zero, whereas a lower case `x`  outputs `+00`, `+0000`, or `+00:00`.
+
+* With a non-zero offset, **offset-O** formats the localized offset based on the number of characters.
++
+One character outputs the short form of the localized offset, which is the localized offset text, like `GMT`.
+It is followed by the hour without leading zero, optional 2-digit minute and second if they are non-zero, and a colon, for example `GMT+8`.
++
+Four characters output the full form, which is a localized offset text with a 2-digit hour and minute field, optional second field if non-zero, and colon, for example `GMT+08:00`.
++
+If the offset is zero, only the localized text is output.
++
 Other character amounts result in an error.
 
-| "offset-Z" formats the offset based on the number of characters.
-
-One, two or three characters output the hour and minute, without a colon, such as '+0130'. If the offset is zero, the output will be '+0000'.
-
-Four characters outputs the full form of the localized offset, equivalent to four characters of "offset-O". If the offset is zero, the output will be the corresponding localized offset text.
-
-Five characters output the hour, minute, with optional second if non-zero, with colon. If the offset is zero, the output is 'Z'.
-
+* **offset-Z** formats the offset based on the number of characters.
++
+One, two or three characters output the hour and minute, without a colon, such as `+0130`.
+If the offset is zero, the output will be `+0000`.
++
+Four characters outputs the full form of the localized offset, equivalent to four characters of **offset-O**.
+If the offset is zero, the output will be the corresponding localized offset text.
++
+Five characters output the hour, minute, with optional second if non-zero, with colon. If the offset is zero, the output is `Z`.
++
 More characters will result in an error.
 
-| The "pad modifier" modifies the pattern that immediately follows to be padded with spaces. The pad width is determined by the number of pattern characters.
+* The **pad modifier** modifies the pattern that immediately follows to be padded with spaces.
+The pad width is determined by the number of pattern characters.
 
-| Any character that is not reserved, other than '[', ']', '{', '}', '#', and the single quote are output directly. To ensure future compatibility it is recommended to wrap all characters that you want to output directly with single quotes.
+* Any character that is not reserved, other than `[`, `]`, `{`, `}`, `#`, and `'` are output directly.
+To ensure future compatibility it is recommended to wrap all characters that you want to output directly with single quotes.
 
-|===
+======
 
 .Instance formatting with year, month, day, hour, minute, second, fraction-of-second and zone-offset
 ======