@ gravity-ui/ date- utils (简体中文)
管理日期和时间的助手.
安装
npm i @gravity-ui/date-utils
使用量
import {dateTimeParse, dateTime} from '@gravity-ui/date-utils';
// Current date: 2021-08-07T12:10:00
// User's time zone: Europe/Istanbul
const FORMAT = 'YYYY-MM-DDTHH:mm:ssZ';
// parse absolute date
dateTimeParse({year: 2021, month: 7, day: 7})?.format(FORMAT); // "2021-08-07T00:00:00+03:00"
dateTimeParse([2021, 7, 7])?.format(FORMAT); // "2021-08-07T00:00:00+03:00"
dateTimeParse('2021-08-07')?.format(FORMAT); // "2021-08-07T00:00:00+03:00"
dateTimeParse(1621708204063)?.format(FORMAT); // "2021-05-22T21:30:04+03:00"
dateTimeParse('')?.format(FORMAT); // undefined
dateTimeParse('incorrect-date')?.format(FORMAT); // undefined
// parse relative date
dateTimeParse('now')?.format(FORMAT); // "2021-08-07T12:10:00+03:00"
dateTimeParse('now-1d')?.format(FORMAT); // "2021-08-06T12:10:00+03:00"
dateTimeParse('now-1d+1M')?.format(FORMAT); // "2021-09-06T12:10:00+03:00"
dateTimeParse('now/d')?.format(FORMAT); // "2021-08-07T00:00:00+03:00"
dateTimeParse('now+1d/d')?.format(FORMAT); // "2021-08-08T00:00:00+03:00"
dateTimeParse('now-1f')?.format(FORMAT); // undefined
// create dateTime
dateTime().format(FORMAT); // "2021-08-07T12:10:00+03:00"
dateTime({input: '2021-08-07'}).format(FORMAT); // "2021-08-07T00:00:00+03:00"
dateTime({input: '2021-08-07', format: 'YYYY-MM-DD'}).format(FORMAT); // "2021-08-07T00:00:00+03:00"
dateTime({timeZone: 'Asia/Tokyo'}).format(FORMAT); // "2021-08-07T18:10:00+09:00
dateTime({input: ''}).format(FORMAT); // "Invalid Date"
dateTime({input: '2021-08', format: 'YYYY-MM-DD'}).format(FORMAT); // "Invalid Date"
设置
import {settings} from '@gravity-ui/date-utils';
// Locales management
settings.getLocale(); // default locale "en"
settings.loadLocale('de').then(() => {
settings.setLocale('de');
settings.getLocale(); // "de"
});
// Customization
settings.updateLocale({weekStart: 0}); // change first day of week
许可证
根据麻省理工学院的许可证分发。 见 自由主义 详细情况.
对于人工智能特工
时区认识日期/时间帮助者——解析(包括相对表达式如: now-1d/d),格式化,和地产管理——没有任何UI,当你需要计算和格式化的日期可靠地跨时区时,而不是拉入一个完整的UI日历时,就会到达.
何时使用
- 解析绝对或相对日期表达式( E)
'now-1d', (中文(简体) ),'now/d')进入时区意识dateTime对象. - 格式化在用户的时区中显示的日期, 并有 locale 支持 .
- 在服务器(节点)和客户端(反应)代码之间共享日期逻辑——该软件包没有反应依赖性.
不使用时
- 制作日历、取出日期或任何日期 用户,使用时
@gravity-ui/date-components——它在这个包上建起它的视觉. - 对于轻量级不可变的日期数学和没有时区/相对表达需要,
date-fns或当地人Intl编号 :DateAPI可能就够了.
常见陷阱
- 通话
dateTimeParse('')需要一个日期 ——返回undefined,而不是一个dateTime; 以可选的链条或无效检查来守护. - 忘记装入一个地方 —— 说
settings.setLocale('de')仅格式化本地化名称(周日、月)settings.loadLocale('de')已经解决了. - 迷幻函数
formatDate编号 :parseDate- 切入点是dateTimeParse(页)和dateTime(...).format(...)(格式). - 假设用户的时区自动应用 - 通过
timeZone或使用系统时区.
AI代理的文件
安装版本的可代理读取文档位于 node_modules/@gravity-ui/date-utils/build/docs/INDEX.md。 。 。 .