@soei/time

1.1.1 • Public • Published

线上示例

时间工具类

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()后的结果

Package Sidebar

Install

npm i @soei/time

Weekly Downloads

3

Version

1.1.1

License

ISC

Unpacked Size

25.3 kB

Total Files

5

Last publish

Collaborators

  • soeiz