Initializing RtcDateTime from strings...

[Makuna]

I am working on a general purpose parser for date/time strings to RtcDateTime.

If you have had the need or have code already to do this, could you share the actual string you parse. Not the code, just the string, like "Sat, 06 Dec 2009 12:34:56 GMT".

I want to build up a reasonable collection of test data with example "format" specifiers.

[Makuna]

While present in Master, a new release has not been made yet.

RtcDateTime.InitWithIso8601() is being replaced with a more versatile method that allows the user to provide a "format" string that defines how to parse a date-time string. For now it will remain but marked as deprecated.

Here is an example that demonstrates its use that matches the old InitWithIso8601() implementation.

RtcDateTime datetime;

datetime.InitWithDateTimeFormatString(F("*, DD MMM YYYY hh:mm:ss"), date);

Note that it supports time zone adjustments to GMT/zulu time if your string has a time zone code and you supplied the format with a matching time-zone token ('z', 'zzz'); The matching is done using English with only the US time-zones are present in the table. To use English but with a comprehensive global list, use RtcLocalEn template argument like

datetime.InitWithDateTimeFormatString<RtcLocaleEn>(F("*, DD MMM YYYY hh:mm:ss zzz"), date);

Note: Due to some abbreviation collisions, the current RtcLocalEn is arbitrary in which is included, so it is recommended that you copy it and modify it to your needs.
If you want to create a localized version of the table, you can provide your own by copying the RtcLocaleEn file and localizing the text and or adding your own entries. Here is an example using a yet unimplemented RtcLocale for German.

datetime.InitWithDateTimeFormatString<RtcLocaleDe>(F("*, DD MMM YYYY hh:mm:ss zzz"), date);

The format tokens are as follows:
* - ignore until next char
YY - two digit year, assumes 2000 +
YYYY - four digit year
M - full month name, arbitrary length until next char
MM - two digit month
MMM - abbreviated month name, 3 chars
DD - two digit day of month
hh - hour
mm - minute
ss - seconds
sssss - seconds with decimal (12.34), the decimal part will be ignored.
z - +hh:mm or Z -
using this will adjust the time to UTC from the time-zone
present in the string,
without it, it will ignore the time-zone and return the local
note: + or - must be present before hour/minute time-zone offset in the string.
zzz - time zone abbreviation
using this will adjust the time to UTC from the time-zone
present in the string,
without it, it will ignore the time-zone and return the local

[Makuna]

now active in v2.4.0