JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 2
  • Score
    100M100P100Q33356F
  • License ISC

Format Date : 'YYYY-MM-DD (子|丑|丑|寅|寅|卯|卯|辰|辰|巳|巳|午|午|未|未|申|申|酉|酉|戌|戌|亥|亥|子)时 24h:mm:ss 周week' => '2023-12-25 子时 23:59:40 周一'

Package Exports

  • @soei/time
  • @soei/time/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@soei/time) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

安装 Latest Version on NPM

时间工具类 Latest Version on NPM Software License npm npm bundle size

2016-05-16(小棉袄生日 🎂)

下面日历数据参考 (# t.days)

一 二 三 四 五 六 日
25 26 27 28 29 30 1
2 3 4 5 6 7 8
9 10 11 12 13 14 15
16 17 18 19 20 21 22
23 24 25 26 27 28 29
30 31 1 2 3 4 5

Time

更新日志

版本 1.1.1

  • T.change(obj<T>, mode<String>) 方法

    /**
 * 时间格式转换输出
 * - obj 为 T 类型
 * - mode 为字符串, obj.fire()生成的或者相似的时间字符串
 */
T.change(obj<T>, mode<String>)

let tmode = new Time("YYYYMMDD");
let res = tmode.fire("2024-05-03");
// 20240503

let t = new Time("YYYY/M/D");
t.change(tmode, res);
// 2024/5/3

t = new Time("YYYY*MM*DD");
t.change(t, "2024/5/13");
// 2024*05*13

版本 1.1.0

  • 解决模版为YYYYMMDD时, 月份小于 10 时, 显示为2024-9-3 => 202493, 正确显示: 20240903

    let t = new Time("YYYYMMDD");
t.fire("2024-05-03");
// 20240503
t = new Time("DD-YYYY-MM");
t.fire("2024-05-03");
// 03-2024-05
t = new Time("YYYYMDD");
t.fire("2024-05-03");
// 2024503
t = new Time("YYYY/M/D");
t.fire("2024-05-03");
// 2024/5/3

版本 1.0.17

  • t.days(-1) 参数小于 0 时, 上月数据不能正常获取,导致整体显示异常

    t.days(-1);
/*
[
  { day: '二', title: 'title' },
  { day: '三', title: 'title' },
  { day: '四', title: 'title' },
  { day: '五', title: 'title' },
  { day: '六', title: 'title' },
  { day: '日', title: 'title' },
  { day: '一', title: 'title' },
  ...
]
*/

版本 1.0.16

  • t.days(10) 参数超出 7 时, 数据异常

    t.days(10);
/*
[
{ day: '五', title: 'title' },
{ day: '六', title: 'title' },
{ day: '日', title: 'title' },
{ day: '一', title: 'title' },
{ day: '二', title: 'title' },
{ day: '三', title: 'title' },
{ day: '四', title: 'title' },
...
]
*/

版本 1.0.15

  • 支持 t.fire(Time实例对象) 方法

    let t2 = new Time("YYYY年DD日-MM月");
// t2 : 2022年26日-01月

t.fire(t2);
// 按照 t 的设置的格式输出

版本 1.0.13

  • 新增
    • diff 方法 处理时间对象的年差
      t.diff(T|String|JOSN{ year, month, day })

版本 1.0.11

  • 解决 YYYY-MM-DD hh:MM:ss 时间格式 输出 YYYY-MM-DD 问题

版本 1.0.10

  • 优化 T.date(Models String)

    • 两个对象之间的 Date 数据交换
    var source = new Time("今年是YY年,从MM月开始,从DD日起,下午hh:mm下班");
source.fire();
// 今年是24年,从01月开始,从13日起,下午10:17下班

source.date("今年是2024年,从05月开始,从11日起,下午16:10下班");
// Date对象: 2024-05-11T08:10:00.000Z => 标准时间 +8区

source.fire();
// 今年是24年,从05月开始,从11日起,下午16:10下班

var change = new Time("YYYY年-[DD](MM)hh*mm*ss分");
change.fire(
  /* 返回一个Date对象, 该对象 */
  source.date(
    /* 返回指定数据模版 */
    source.fire(/* '2012-01-09' */)
  )
);
// 2024年-[11](05)16*10*00分

/* date对象做参数 */
change.fire(new Date());
// 2024年-[14](01)11*18*27分

/* 标准时间转本地时间, Date本身就支持 */
change.fire("2024-05-11T08:10:00.000Z");
// 2024年-[11](05)16*10*00分

日期对象 获取 与 实例化

/* 版本 */
/* 版本1.0.8支持 */
// 1. 修复 dates()获取日期JSON问题
// 2. 新增 day方法

// 时间格式化输出
const stringmodule =
  "YYYY-MM-DD (子|丑|丑|寅|寅|卯|卯|辰|辰|巳|巳|午|午|未|未|申|申|酉|酉|戌|戌|亥|亥|子)时 24h:mm:ss";
const Time = require("@soei/time");
let t = new Time(stringmodule);
// 或
import Time from "@soei/time";

t = new Time(stringmodule);

"当前日期::", t.day();
// 当前日期:: 2023-12-18 子时 23:13:14

t.day(-1, true);
// { year: 2023, month: 12, day: 17 }

t.day(-1, true);
// { year: 2023, month: 12, day: 16 }

t.day(-1, true);
// { year: 2023, month: 12, day: 15 }

t.day(-1, true);
// { year: 2023, month: 12, day: 14 }

t.day(-1);
// 2023-12-13 子时 23:13:14

t.day(-1);
// 2023-12-12 子时 23:13:14

t.day(-1);
// 2023-12-11 子时 23:13:14

t.day(-1);
// 2023-12-10 子时 23:13:14

/* 版本1.0.7支持 */
// 修复 days 月份计算问题，导致获取天数为上月天数

/* 版本1.0.6支持 */
/**
 * - 支持 days 当前月多少天
 * - 支持 week 当前天星期几
 *   index 和 weeks 只能存在一个
 **/
let week = new Time("YYYY {week} （week） -week- 本月days天「week」", {
  weeks: "星期一,星期二,星期三,星期四,星期五,星期六,星期日",
  // index: 1/* 0中文（默认）1英文 2日文 3韩文 */
});

week.fire();
// 2023 {星期四} （星期四） -星期四- 本月30天「星期四」

// 时间格式化输出
const stringmodule =
  "YYYY-MM-DD (子|丑|丑|寅|寅|卯|卯|辰|辰|巳|巳|午|午|未|未|申|申|酉|酉|戌|戌|亥|亥|子)时 24h:mm:ss";
const Time = require("@soei/time");
let t = new Time(stringmodule);
// 或
import Time from "@soei/time";
/**
 * stringmodule配置说明
 * YYYY 年
 * MM  月
 * DD   日
 * hh mm ss
 * MM|hh|DD|mm|ss|YYYY|YY|ampm|24h|12h
 * (..|..|..)
 * 24小时平分
 **/
t = new Time(stringmodule);

getDayNumberByMonthAndYear

获取当前月天数

Time.getDayNumberByMonthAndYear(1, 2022);

// 31

fire

格式化输出

t.fire(+new Date());
// 输出: "2023-09-01 申时 15:33:55"

// 或
t.fire("2088-8-8 8:8:8");
// 或
t.fire("2088/8/8 8:8:8");
// 2088-08-08 辰时 08:08:08

dates

获取当前月的详情

// 当前月
t.dates(0);

// { year: 2023, month: 9, day: 1 }

// 下一月
t.dates(1);

// { year: 2023, month: 10, day: 1 }

// 上一月
t.dates(-1);

// { year: 2023, month: 8, day: 1 }

days

获取 当前月 和 相邻月 补位的天数集合

/**
 * 周一显示的的索引[周一的偏移量] 如果是 1 周日在第一位, 2,3,..同理
 * @param {Number} offsetByMonday
 * [
 * |一 | 二 | 三 | 四 | 五 | 六 | 日|           - 0 中文
 * ------------------------------
 * |Mon | Tue | Wed | Thu | Fri | Sat | Sun| - 1 英文
 * ------------------------------
 * |月 | 火 | 水 | 木 | 金 | 土 | 日|          - 2 日文
 * ]
 * ---------------------
 * @param {Number} title
 * 设置指定的年月日
 * {
 *     year: 2022,
 *     month: '10',
 *    day: '9'
 * }
 * @param {JSON} time
 * time未指定: 返回当前月且对应数据 cur == true
 * 指定日期: 返回指定月份
 * @returns
 **/
t.days(offsetByMonday, title, time);

// 获取当前月
t.days(0, 1);

// 获取指定月份的日期集合
t.days(0, 0, {
  year: 2023,
  month: "10",
  /* 指定选中日期 */
  day: "9",
});
/*
[
  { day: '一', title: 'title' },
  { day: '二', title: 'title' },
  { day: '三', title: 'title' },
  { day: '四', title: 'title' },
  { day: '五', title: 'title' },
  { day: '六', title: 'title' },
  { day: '日', title: 'title' },
  { day: 25, month: 9, year: 2023, title: 'prev' },
  ...
  { day: 30, month: 9, year: 2023, title: 'prev' },
  { day: 1, month: 10, year: 2023, title: 'current', cur: false },
  ...
  { day: 9, month: 10, year: 2023, title: 'current', cur: true },
  ...
  { day: 31, month: 10, year: 2023, title: 'current', cur: false },
  { day: 1, month: 11, year: 2023, title: 'next' },
  ...
  { day: 5, month: 11, year: 2023, title: 'next' }
]
*/

date

返回指定日期的对象

t.date("2022-10-20 10:20:30");

// 2022-10-20T02:20:30.000Z
// 这个是对象输出调用toString()后的结果