日期时间

日期时间控件用于选择日期或日期时间，支持多种格式化输出。

属性

sg-caption

• 说明：控件前面的文字
• 类型：string

示例

"sg-caption":"请选择："

---

sg-captionclass

• 说明：控件前面的文字的样式，w1-w7 文字宽度 1-7 个字符，more 省略掉超过的字符（写法：w5 more）
• 类型：string

示例

"sg-captionclass":"w5"

---

sg-require

• 说明：必填项
• 类型：boolean
• 默认值：false

可选值

值	说明
true	是
false	否

示例

"sg-require":true

方法

getDateVal

日期和时间日期控件取值。

语法

getDateVal(selector, fmt)

参数

参数名	类型	必填	说明
selector	string	是	选择器
fmt	string	否	格式（默认 yyyy-MM-dd）

返回值

字符串日期或日期时间格式。

示例

// 获取日期控件的值
var dateValue = getDateVal("#birthDate", "yyyy-MM-dd");
console.log("出生日期: " + dateValue);

// 获取日期时间控件的值
var dateTimeValue = getDateVal("#createDateTime", "yyyy-MM-dd HH:mm:ss");
console.log("创建时间: " + dateTimeValue);

// 使用默认格式
var defaultValue = getDateVal("#defaultDate");
console.log("默认格式日期: " + defaultValue);

备注

只有日期和时间日期控件才支持。

---

setDateVal

日期和时间日期控件赋值。

语法

setDateVal(selector, date)

参数

参数名	类型	必填	说明
selector	string	是	选择器
date	string	是	日期（yyyy-MM-dd）或日期时间（yyyy-MM-dd HH:mm:ss）

返回值

无。

示例

// 设置日期控件的值
setDateVal("#birthDate", "2022-01-01");

// 设置日期时间控件的值
setDateVal("#createDateTime", "2022-01-01 15:30:20");

// 设置当前日期
var today = new Date();
var todayStr = formatDate(today, "yyyy-MM-dd");
setDateVal("#todayDate", todayStr);

备注

只有日期和时间日期控件才支持。

---

formatDate

日期格式转换。

语法

formatDate(date, fmt)

参数

参数名	类型	必填	说明
date	string/Date	是	时间或日期（支持文字格式，也支持 Date 对象，自动识别）
fmt	string	否	格式（默认：yyyy-MM-dd HH:mm:ss）

返回值

格式化后的时间，例如 2022-01-01 15:30:20。

格式说明

格式符	说明	示例
yyyy	四位年份	2022
yy	两位年份	22
MM	两位月份（补零）	01
M	月份（不补零）	1
dd	两位日期（补零）	01
d	日期（不补零）	1
HH	24 小时制（补零）	15
H	24 小时制（不补零）	15
hh	12 小时制（补零）	03
h	12 小时制（不补零）	3
mm	分钟（补零）	30
m	分钟（不补零）	30
ss	秒（补零）	20
s	秒（不补零）	20
SSS	毫秒	123
dddd	星期	星期一
A	上午/下午	AM/PM

示例

// 格式化当前日期
var now = new Date();
var formattedDate = formatDate(now, "yyyy-MM-dd HH:mm:ss");
console.log("当前时间: " + formattedDate);

// 只显示日期部分
var dateOnly = formatDate(now, "yyyy-MM-dd");
console.log("当前日期: " + dateOnly);

// 只显示时间部分
var timeOnly = formatDate(now, "HH:mm:ss");
console.log("当前时间: " + timeOnly);

// 显示中文格式日期
var chineseDate = formatDate(now, "yyyy年MM月dd日");
console.log("中文日期: " + chineseDate);

// 显示带星期的日期
var weekdayDate = formatDate(now, "yyyy-MM-dd dddd");
console.log("带星期日期: " + weekdayDate);

// 显示 12 小时制时间
var twelveHourTime = formatDate(now, "yyyy-MM-dd hh:mm:ss A");
console.log("12小时制时间: " + twelveHourTime);

// 显示毫秒
var withMs = formatDate(now, "yyyy-MM-dd HH:mm:ss.SSS");
console.log("带毫秒时间: " + withMs);

// 显示短格式日期
var shortDate = formatDate(now, "yy-M-d");
console.log("短格式日期: " + shortDate);

// 显示 ISO 格式
var isoFormat = formatDate(now, "yyyy-MM-ddTHH:mm:ss");
console.log("ISO格式: " + isoFormat);

// 使用字符串日期作为输入
var stringDate = formatDate("2022-01-01 15:30:20", "yyyy年MM月dd日 HH时mm分");
console.log("字符串日期格式化: " + stringDate);

备注

date 可以是字符串的时间，也可以是 date() 对象，自动识别。