datefmt ~master
Datetime parsing and formatting
To use this package, run the following command in your project's root directory:
Manual usage
Put the following dependency into your project's dependences section:
datefmt
Date formatting and parsing based on strftime
.
Basic Usage
You can parse something by just calling parse
:
import datefmt;
auto st = "Thu, 17 Apr 2014 14:47:35 GMT".parse("%a, %d %b %Y %H:%M:%S GMT");
assert(st == SysTime(DateTime(2014, 4, 17, 14, 47, 35), UTC()));
And you can convert it to string the same way:
auto st = SysTime(DateTime(2014, 4, 17, 14, 47, 35), UTC());
auto formatted = st.format("%a, %d %b %Y %H:%M:%S GMT");
assert(formatted == "Thu, 17 Apr 2014 14:47:35 GMT");
datefmt also supports the tryParse pattern popularized by C#:
SysTime st;
if (tryParse(userInput, "%a, %d %b %Y %H:%M:%S GMT", st))
{
// use the value
}
Format sets
Some standards, like ISO8601, specify a collection of related formats. If you have a document that
must provide values in ISO8601 format, a compliant document might include a date like 20100418
,
2018-12-15T13:00
, or 1904-10-18 04:00:00.000000Z
.
To handle this, datefmt has a notion of format collections, simply called Format
. A Format has a
primary format, which is used for converting to string, and an array of alternative forms that are
used for parsing.
It's simple to make your own:
Format customFormat = {
primaryFormat: "%a, %d %b %Y %H:%M:%S %Z",
formatOptions: [
"%d %b %Y %H:%M:%S %Z",
"%a %d %b %Y %H:%M:%S %Z",
"%a, %d %b %Y %H:%M:%S",
]
};
SysTime st = parse(someRfcishString, customFormat);
Dub
Add a dependency on "datefmt": "~>1.0.0"
.
- Registered by Christopher Wright
- ~master released 5 years ago
- dhasenan/datefmt
- Ms-PL
- Copyright © 2017, dhasenan
- Authors:
- Dependencies:
- none
- Versions:
-
1.0.4 2019-Nov-28 1.0.3 2019-May-14 1.0.2 2017-Dec-20 1.0.1 2017-Dec-14 1.0.0 2017-Dec-12 - Download Stats:
-
-
1 downloads today
-
4 downloads this week
-
14 downloads this month
-
1117 downloads total
-
- Score:
- 1.2
- Short URL:
- datefmt.dub.pm