未来之窗昭和仙君 - cyberwin_fairyalliance_webquery

日期格式化功能说明

一、功能概述

日期格式化功能提供了灵活的日期时间格式化工具，通过简单的格式字符串，可以将JavaScript的Date对象转换为各种自定义的日期时间字符串格式，满足不同场景下的日期展示需求。

该功能支持多种常见的日期时间格式，包括年、月、日、时、分、秒、毫秒和季度等，通过简洁的格式占位符即可实现复杂的日期格式化。

二、核心函数与参数

函数名	参数	返回值	功能说明
`cyberwinformat_date()`	`options`（对象，必选）：包含以下属性 - `date`：Date对象，要格式化的日期时间 - `str`：字符串，格式字符串，包含格式占位符	字符串：格式化后的日期时间字符串	将指定的Date对象按照格式字符串转换为对应的日期时间字符串
`未来之窗_时间_格式化()`		字符串：格式化后的日期时间字符串	将指定的Date对象按照格式字符串转换为对应的日期时间字符串

格式占位符说明

格式字符串中可以包含以下占位符，这些占位符会被对应的日期时间部分替换：

占位符	说明	示例
`y+`	年份（1-4位）	`yyyy` → 2025；`yy` → 25
`M+`	月份（1-2位）	`MM` → 09；`M` → 9
`d+`	日期（1-2位）	`dd` → 05；`d` → 5
`h+`	小时（1-2位，24小时制）	`hh` → 14；`h` → 9
`m+`	分钟（1-2位）	`mm` → 08；`m` → 8
`s+`	秒钟（1-2位）	`ss` → 03；`s` → 3
`q+`	季度（1-4）	`q` → 3（表示第三季度）
`S`	毫秒（1-3位）	`S` → 789

三、使用示例

将指定日期格式化为常用的日期格式：

交互演示：

当前日期：

格式：yyyy-MM-dd

格式：yyyy年MM月dd日

格式：MM/dd/yyyy

格式化结果将显示在这里...

格式化示例代码：

// 创建一个日期对象（2025年9月25日） const date = new Date(2025, 8, 25); // 注意：月份从0开始计数 // 格式化为"yyyy-MM-dd" const format1 = $cq.cyberwinformat_date({ date: date, str: "yyyy-MM-dd" }); console.log(format1); // 输出: "2025-09-25" // 格式化为"yyyy年MM月dd日" const format2 = $cq.未来之窗_时间_格式化({ date: date, str: "yyyy年MM月dd日" }); console.log(format2); // 输出: "2025年09月25日"

将日期时间格式化为包含时、分、秒的完整格式：

交互演示：

当前日期时间：

格式：yyyy-MM-dd hh:mm:ss

格式：yyyy-MM-dd hh:mm:ss.S

格式：hh:mm:ss

格式化结果将显示在这里...

格式化示例代码：

// 创建一个包含时间的日期对象 const datetime = new Date(2025, 8, 25, 14, 35, 42, 789); // 格式化为"yyyy-MM-dd hh:mm:ss" const format1 = $cq.cyberwinformat_date({ date: datetime, str: "yyyy-MM-dd hh:mm:ss" }); console.log(format1); // 输出: "2025-09-25 14:35:42" // 包含毫秒的格式化 const format2 = $cq.未来之窗_时间_格式化({ date: datetime, str: "yyyy-MM-dd hh:mm:ss.S" }); console.log(format2); // 输出: "2025-09-25 14:35:42.789"

使用自定义格式和季度占位符进行格式化：

交互演示：

格式：yyyy年第q季度

格式：MM-dd hh:mm

格式：yy-M-d h:m

格式化结果将显示在这里...

格式化示例代码：

// 创建日期对象 const date = new Date(2025, 8, 25, 14, 5); // 季度格式化 const quarterFormat = $cq.cyberwinformat_date({ date: date, str: "yyyy年第q季度" }); console.log(quarterFormat); // 输出: "2025年第3季度" // 精简格式 const shortFormat = $cq.未来之窗_时间_格式化({ date: date, str: "yy-M-d h:m" }); console.log(shortFormat); // 输出: "25-9-25 14:5"