DatetimeJs
Python-like datetime class with formatter and parser
Installation
npm i python-datetime
For browser, download index.js and rename it to e.g.: datetime.js.
https://www.npmjs.com/package/python-datetime
Usage
CommonJS
const {Datetime, Timedelta} = require('python-datetime');
ES6 module (adding type: "module" to package.json)
import {Datetime, Timedelta} from 'python-datetime';
Browser
<script src="./index.js"></script>
or check test.html for simple usage
Syntax
new Datetime(year, month, day, hour, minute, second, millisecond);
new Timedelta(days, hours, minutes, seconds, milliseconds);
Parameters
Check https://docs.python.org/3/library/datetime.html.
Or check Examples below.
Examples
now() and toString()
Datetime.now().toString()
'Datetime(year=2022, month=5, day=5, hour=12, minute=10, second=16, millisecond=258)'
.format(formatString)
let dt = new Datetime(2345, 5, 16, 17, 28, 39, 10);
dt.format('%a %A %w %d %b %B %m %y %Y %H %I %p %M %S %j %U %W %c %x %X %% ')
'Wed Wednesday 3 16 May May 05 45 2345 17 05 PM 28 39 136 19 20 Wed May 16 17:28:39 2345 05/16/45 17:28:39 % '
timestamp (valueOf())
console.log(+Datetime.now());
+Datetime.now() == Date.now()
1651724057047
true
fromTimestamp(ts)
Datetime.fromTimestamp(Date.now()).toString()
'Datetime(year=2022, month=5, day=5, hour=12, minute=15, second=5, millisecond=728)'
utc(year, month, day, hour, minute, second, millisecond)
Datetime.utc(1234, 6, 6).toString()
'Datetime(year=1234, month=6, day=6, hour=7, minute=36, second=42, millisecond=0)'
from({year, month, day, hour, minute, second, millisecond})
Datetime.from(Datetime.now()).toString()
'Datetime(year=2022, month=5, day=5, hour=12, minute=22, second=59, millisecond=359)'
fromDate(date)
Datetime.fromDate(new Date()).toString()
'Datetime(year=2022, month=5, day=5, hour=12, minute=23, second=47, millisecond=414)'
.create(args)
let date = new Date();
let a = Datetime.create(Datetime.fromDate(date)).toString();
let b = Datetime.create(date).toString();
let c = Datetime.create(+date).toString();
a == b && b == c
true
isoformat(sep = 'T')
new Datetime(2022, 1, 2, 3, 4, 5, 6).isoformat('XD')
'2022-01-02XD03:04:05.006'
parse(dateString, formatString)
Datetime.parse('31 Sun 2021', '%W %a %Y').format('%c')
'Sun Aug 08 00:00:00 2021'
Datetime.parse('@@ Tue Aug 16 21:30:00 1988 --', '@@ %c --').format('%c')
'Tue Aug 16 21:30:00 1988'
Datetime.parse('21:30:00', '%X').format('%X')
'21:30:00'
Datetime.parse('@@ Tue Aug 16 21:30:00 1988 --', '@@ %c --').isoformat()
'1988-08-16T21:30:00.000'
%j directive (number of days since the beginning of the year)
Datetime.parse('2022 115', '%Y %j').format('%c')
'Mon Apr 25 00:00:00 2022'
date()
Datetime.now().date().getTime() == new Date().getTime()
true
replace({year, month, day, hour, minute, second, millisecond})
Datetime.create(1234567).replace({year: 2022}).isoformat()
'2022-01-01T08:20:34.567'
Timedelta
Timedelta.create(Datetime.create(2022, 4, 25) - Datetime.create(2021, 4, 25)).toString()
'Timedelta(days=365, hours=0, minutes=0, seconds=0, milliseconds=0)'
Leap year
Timedelta.create(Datetime.create(2021, 2, 1) - Datetime.create(2020, 2, 1)).toString()
'Timedelta(days=366, hours=0, minutes=0, seconds=0, milliseconds=0)'
add() sub()
Datetime.create(2022, 4, 25).add(new Timedelta(1, 2)).toString()
'Datetime(year=2022, month=4, day=26, hour=2, minute=0, second=0, millisecond=0)'
operators
new Timedelta(1, 2).mul(2)
'Timedelta(days=2, hours=4, minutes=0, seconds=0, milliseconds=0)'
Timedelta.create(new Timedelta(1, 2) * 10)
'Timedelta(days=10, hours=20, minutes=0, seconds=0, milliseconds=0)'