moment().format方法詳解

一、概述

moment.js是一款JavaScript日期處理庫，可以用於解析、驗證、操作和顯示日期。moment().format()是其中一個常用的方法，用於將日期轉換為指定格式的字元串。

下面是一個簡單的使用moment().format()的例子：

const now = moment();
const formatted = now.format("YYYY年MM月DD日");
console.log(formatted); // 輸出示例：2022年01月01日

二、格式說明

moment().format()的格式字元串（第二個參數）由多個佔位符組成，用於指定日期輸出的格式。常見的佔位符如下：

• YYYY：4位數年份
• YY：2位數年份
• MM：2位數月份，從01到12
• M：1位數月份，從1到12
• DD：2位數日期，從01到31
• D：1位數日期，從1到31
• HH：24小時制小時數，從00到23
• H：24小時制小時數，從0到23
• hh：12小時制小時數，從01到12
• h：12小時制小時數，從1到12
• mm：2位數分鐘數，從00到59
• m：1位數分鐘數，從0到59
• ss：2位數秒數，從00到59
• s：1位數秒數，從0到59
• SSS：3位數毫秒數
• a：上午/下午標記

除佔位符外，格式字元串中還可以包含其他非數字字元，如空格、連字元、斜杠、中文字元等，這些字元會原樣輸出。

下面是一個完整的使用moment().format()的例子：

const now = moment();
const formatted = now.format("YYYY-MM-DD HH:mm:ss.SSS a");
console.log(formatted); // 輸出示例：2022-01-01 08:30:00.000 上午

三、常見問題

1、時區問題

moment.js默認使用本地時區進行日期處理，如果需要使用其他時區，則需要使用moment-timezone插件。

// 引入moment-timezone插件
const moment = require('moment-timezone');

// 在格式字元串中添加時區偏移量
const now = moment().tz('Asia/Shanghai');
const formatted = now.format('YYYY-MM-DD HH:mm:ss');
console.log(formatted); // 輸出示例：2022-01-01 08:30:00

上面的例子中，使用了Asia/Shanghai時區的偏移量，將當前時間轉換為上海時間的字元串。

2、多語言問題

moment.js可以輕鬆處理多語言日期格式化，只需要將對應的語言包引入即可。

// 引入中文語言包
import moment from 'moment';
import 'moment/locale/zh-cn';

// 設置語言
moment.locale('zh-cn');

// 使用中文語言格式化日期
const now = moment();
const formatted = now.format("YYYY年MM月DD日");
console.log(formatted); // 輸出示例：2022年01月01日

上面的例子中，使用了zh-cn語言包，將該moment實例的語言設置為中文，將時間格式化為中文字元串。

3、時間戳問題

moment.js可以方便地處理時間戳，只需要將時間戳作為參數傳遞給moment()方法即可。

const timestamp = 1641065400000; // 時間戳，單位是毫秒
const formatted = moment(timestamp).format('YYYY-MM-DD HH:mm:ss');
console.log(formatted); // 輸出示例：2022-01-02 10:10:00

上面的例子中，將時間戳1641065400000作為參數傳遞給moment()方法，得到一個moment實例，再使用format()方法將該實例格式化為字元串。