logo

utils-std

Collection of commonly available Unix tools git clone https://anongit.hacktivis.me/git/utils-std.git/

iso_parse.mdoc (1297B)

    

  1. .\" utils-std: Collection of commonly available Unix tools
  2. .\" Copyright 2017 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
  3. .\" SPDX-License-Identifier: MPL-2.0
  4. .\"
  5. .\" Example:
  6. .\" .Fl d Ar datetime
  7. .\" .so lib/iso_parse.mdoc
  8. .\"
  9. Should be formatted either with a leading @ (at) symbol followed by
  10. the Unix timestamp (number of seconds before and after 1970-01-01 00:00:00Z),
  11. for example
  12. .Ql @1698791420
  13. corresponds to 2023-10-31 23:30:20 UTC
  14. .Pp
  15. Or as Email / "Internet Message Format" (RFC5322, RFC2822, RFC822), for example:
  16. .Bl -bullet -compact
  17. .It
  18. .Ql Fri, 21 Nov 1997 09:55:06 -0600
  19. .It
  20. .Ql 21 Nov 97 09:55:06 GMT
  21. .El
  22. .Pp
  23. Or an
  24. .Xr asctime 3 Ns -like
  25. format, for example:
  26. .Ql Sun Sep 16 01:03:52 1973
  27. .Pp
  28. Or as RFC3339 which looks like
  29. .Ql YYYY-MM-DDThh:mm:SS[frac][tz] ,
  30. where:
  31. .Bl -tag -width Ds
  32. .It Ql YYYY-MM-DD
  33. Corresponds to %Y-%m-%d of
  34. .Xr strptime 3 .
  35. .It Ql T
  36. Is either
  37. .Ql T
  38. or a space.
  39. .It Ql [frac]
  40. Is either empty, or fractional seconds starting with either a comma
  41. .Pq \&,
  42. or a period
  43. .Pq \&. .
  44. .It Ql [tz]
  45. When empty it corresponds to local time.
  46. Otherwise it can be an UTC offset in the format
  47. .Ql [+-]HH:?MM
  48. or the letter
  49. .Qq Z ,
  50. signifying UTC.
  51. .El
  52. .Pp
  53. Some examples:
  54. .Bl -bullet -compact
  55. .It
  56. .Ql 2003-06-02T13:37:42.713Z
  57. .It
  58. .Ql 1971-01-02T03:04:05.678+0900
  59. .El