Moment.js 日期處理插件 · thinkphp6文檔

[Moment.js 中文網 (momentjs.cn)](http://momentjs.cn/) #### 年份、月份、日期的令牌令牌區分大小寫。 | 輸入 | 示例 | 描述 | | --- | --- | --- | | `YYYY` | `2014` | 4 或 2 位數字的年份 | | `YY` | `14` | 2 位數字的年份 | | `Y` | `-25` | 帶有任意數字和符號的年份 | | `Q` | `1..4` | 年份的季度。將月份設置為季度的第一個月 | | `M MM` | `1..12` | 月份數字 | | `MMM MMMM` | `Jan..December` | 語言環境中的月份名稱，由`moment.locale()`設置 | | `D DD` | `1..31` | 月的某天 | | `Do` | `1st..31st` | 月的某天，帶序數 | | `DDD DDDD` | `1..365` | 年的某天 | | `X` | `1410715640.579` | Unix 時間戳 | | `x` | `1410715640579` | Unix 毫秒時間戳 | #### 周年、星期、工作日的令牌對于這些，小寫字母令牌使用語言環境感知的星期開始天數，而大寫字母令牌使用[ISO 星期日期](http://nodejs.cn/s/MkHCug)開始天數。令牌區分大小寫。 | 輸入 | 示例 | 描述 | | --- | --- | --- | | `gggg` | `2014` | 語言環境的 4 位數字的周年 | | `gg` | `14` | 語言環境的 2 位數字的周年 | | `w ww` | `1..53` | 語言環境的年的第幾周 | | `e` | `0..6` | 語言環境的星期幾 | | `ddd dddd` | `Mon...Sunday` | 語言環境的星期幾的名稱，由`moment.locale()`設置 | | `GGGG` | `2014` | ISO 的 4 位數字的周年 | | `GG` | `14` | ISO 的 2 位數字的周年 | | `W WW` | `1..53` | ISO 的年的第幾周 | | `E` | `1..7` | ISO 的星期幾 | #### 語言環境感知的格式使用`LT LTS L LL LLL LLLL`也可以使用語言環境感知的日期和時間格式。它們新增于**2.2.1**版本，其中`LTS`新增于**2.8.4**。令牌區分大小寫。 | 輸入 | 示例 | 描述 | | --- | --- | --- | | `L` | `04/09/1986` | 日期（以本地格式） | | `LL` | `September 4 1986` | 月份名稱、月份日期、年份 | | `LLL` | `September 4 1986 8:30 PM` | 月份名稱、月份日期、年份、時間 | | `LLLL` | `Thursday, September 4 1986 8:30 PM` | 星期幾、月份名稱、月份日期、年份、時間 | | `LT` | `08:30 PM` | 時間（不含秒鐘） | | `LTS` | `08:30:00 PM` | 時間（含秒鐘） | #### 小時、分鐘、秒種、毫秒、偏移量的令牌令牌區分大小寫。 | 輸入 | 示例 | 描述 | | --- | --- | --- | | `H HH` | `0..23` | 小時（24 小時制） | | `h hh` | `1..12` | 小時（使用`a A`的 12 小時制） | | `k kk` | `1..24` | 小時（從 1 到 24 的 24 小時制） | | `a A` | `am pm` | 上午或下午（單一字符`a p`也被視為有效） | | `m mm` | `0..59` | 分鐘 | | `s ss` | `0..59` | 秒鐘 | | `S SS SSS` | `0..999` | 帶分數的秒鐘 | | `Z ZZ` | `+12:00` | 從 UTC 偏移為`+-HH:mm`、`+-HHmm`或`Z` | Moment.js 使用重載的 getter 和 setter 方法。此模式類似與其在 jQuery 中的使用。不帶參數調用這些方法會作為 getter，而帶參數調用則會作為 setter。這些會映射到原生`Date`對象上的相應函數。 ~~~javascript moment().seconds(30).valueOf() === new Date().setSeconds(30); moment().seconds() === new Date().getSeconds(); ~~~ 如果處于[UTC 模式](http://nodejs.cn/s/t4J2Y4)中，則它們將會映射到 UTC 的等效項。 ~~~javascript moment.utc().seconds(30).valueOf() === new Date().setUTCSeconds(30); moment.utc().seconds() === new Date().getUTCSeconds(); ~~~ >[danger]如果鏈接多個操作以構造一個日期，則應從年份、月份、日期等依次開始。否則，可能會得到意外的結果錯誤：`moment().date(day).month(month).year(year)` 正確：`moment().year(year).month(month).date(day)` [millisecond()](http://momentjs.cn/docs/#/get-set/millisecond/) 獲取或設置毫秒接受 0 到 999 之間的數字。如果超出范圍，則它將會冒泡到秒鐘 [second()](http://momentjs.cn/docs/#/get-set/second/)獲取或設置秒鐘接受 0 到 59 之間的數字。如果超出范圍，則它將會冒泡到分鐘 [minute()](http://momentjs.cn/docs/#/get-set/minute/)獲取或設置分鐘接受 0 到 59 之間的數字。如果超出范圍，則它將會冒泡到小時。 [hour()](http://momentjs.cn/docs/#/get-set/hour/)獲取或設置小時接受 0 到 23 之間的數字。如果超出范圍，則它將會冒泡到日期 [date()](http://momentjs.cn/docs/#/get-set/date/)獲取或設置月份的日期接受 1 到 31 之間的數字。如果超出范圍，則它將會冒泡達到月份 [day()](http://momentjs.cn/docs/#/get-set/day/)獲取或設置星期幾此方法可用于設置星期幾，其中星期日為 0、星期六為 6 如果超出范圍，則它將會冒泡到其他星期 [weekday()](http://momentjs.cn/docs/#/get-set/weekday/)根據語言環境獲取或設置星期幾 [isoWeekday()](http://momentjs.cn/docs/#/get-set/iso-weekday/)獲取或設置[ISO 星期幾](http://nodejs.cn/s/MkHCug)，其中`1`是星期一、`7`是星期日 [dayOfYear()](http://momentjs.cn/docs/#/get-set/day-of-year/)獲取或設置年份的日期接受 1 到 366 之間的數字。如果超出范圍，則它將會冒泡到年份 [week()](http://momentjs.cn/docs/#/get-set/week/)獲取或設置年份的星期 [isoWeek()](http://momentjs.cn/docs/#/get-set/iso-week/)獲取或設置[年份的 ISO 星期](http://nodejs.cn/s/MkHCug) [month()](http://momentjs.cn/docs/#/get-set/month/)獲取或設置月份 [quarter()](http://momentjs.cn/docs/#/get-set/quarter/)獲取或設置季度 [year()](http://momentjs.cn/docs/#/get-set/year/)獲取或設置年份 [weekYear()](http://momentjs.cn/docs/#/get-set/week-year/)根據語言環境獲取或設置周年 [isoWeekYear()](http://momentjs.cn/docs/#/get-set/iso-week-year/)獲取或設置[ISO 周年](http://nodejs.cn/s/MkHCug) [weeksInYear()](http://momentjs.cn/docs/#/get-set/weeks-in-year/)根據語言環境獲取當前 moment 年份的周數。 [isoWeeksInYear()](http://momentjs.cn/docs/#/get-set/iso-weeks-in-year/)根據[ISO 星期](http://nodejs.cn/s/MkHCug)獲取當前 moment 年份的周數 [get()](http://momentjs.cn/docs/#/get-set/get/) [set()](http://momentjs.cn/docs/#/get-set/set/) [max()](http://momentjs.cn/docs/#/get-set/max/)返回給定的 moment 實例的最大值 [min()](http://momentjs.cn/docs/#/get-set/min/)返回給定的 moment 實例的最小值 ## [操作](http://momentjs.cn/docs/#/manipulating/) [add()](http://momentjs.cn/docs/#/manipulating/add/) 通過增加時間來改變原始的 moment [subtract()](http://momentjs.cn/docs/#/manipulating/subtract/) 通過減去時間來改變原始的 moment [startOf()](http://momentjs.cn/docs/#/manipulating/start-of/) 通過將原始的 moment 設置為時間單位的開頭來對其進行更改(月日分秒等的最小值) [endOf()](http://momentjs.cn/docs/#/manipulating/end-of/) 通過將原始的 moment 設置為時間單位的末尾來對其進行更改（月日分秒等的最大值） [max()](http://momentjs.cn/docs/#/manipulating/max/) [min()](http://momentjs.cn/docs/#/manipulating/min/) [local()](http://momentjs.cn/docs/#/manipulating/local/) 在原始的 moment 上設置標記，以使用本地時間（而不是原始的 moment 時間）顯示 moment [utc()](http://momentjs.cn/docs/#/manipulating/utc/) 在原始的 moment 上設置標記，以使用 UTC（而不是原始的 moment 時間）顯示 moment [utcOffset()](http://momentjs.cn/docs/#/manipulating/utc-offset/) 取 UTC 偏移量（以分鐘為單位） [zone()](http://momentjs.cn/docs/#/manipulating/timezone-offset/) ## [顯示](http://momentjs.cn/docs/#/displaying/) [format()](http://momentjs.cn/docs/#/displaying/format/) ``` var day = moment("1995-12-25");//Mon Dec 25 1995 00:00:00 GMT+0800 var now =moment().format(); var now =moment("12/25/1995", "MM-DD-YYYY").format();//1995-12-25T00:00:00+08:00 var now =moment('2012 July', 'YYYY MMM', 'en').format();//1995-12-25T00:00:00+08:00 //如果不知道輸入字符串的確切格式，但是知道它可能是多種格式之一，則可以使用格式數組 var now =moment("12-25-1995", ["MM-DD-YYYY", "YYYY-MM-DD"]).format();//1995-12-25T00:00:00+08:00 var now =moment(1318781876406).format();//毫秒級2011-10-17T00:17:56+08:00 var now =moment.unix(1318781876).format();//秒級2011-10-17T00:17:56+08:00 //[year, month, day, hour, minute, second, millisecond] 里面的幾個參數都可以省略 var now =moment([2010, 1, 14, 15, 25, 50, 125]).format();//2010-02-14T15:25:50+08:00 var now =moment([]).format();//空數組就是當前時間2021-09-26T09:07:27+08:00 ``` ``` //本月第一天 moment().startOf('month').format('YYYY-MM-DD'); //2020-12-01 //本月最后一天 moment().endOf('month').format('YYYY-MM-DD'); //2020-12-31 //上個月第一天 moment().subtract(1,'month').startOf('month').format('YYYY-MM-DD') //2020-11-01 //上月最后一天 moment().subtract(1,'month').endOf('month').format('YYYY-MM-DD') //2020-11-30 //今年第一天 moment().startOf('year').format('YYYY-MM-DD') //2020-01-01 //去年第一天 moment().subtract(1,'year').startOf('year').format('YYYY-MM-DD') //2019-01-01 //去年后一天 moment().subtract(1,'year').endOf('year').format('YYYY-MM-DD') //2019-12-31 //一年前 moment().subtract(1,'year').format('YYYY-MM-DD'); //2019-12-02 //昨天 moment().subtract(1,'day').format('YYYY-MM-DD') //2020-12-01 //今天 moment().format('YYYY-MM-DD') //2020-12-02 ```