函数表达式
$w.ABS#
$w.ABS(number:number):number
功能描述#
计算传入数字的绝对值
$w.Min#
$w.Min(...numbers: number[]):number
功能描述#
返回一组数字中的最小值
$w.Max#
$w.Max(...numbers: number[]):number
功能描述#
返回一组数字中的最大值
$w.Average#
$w.Average(...numbers: number[]):number
功能描述#
返回一组数字中的平均值
$w.Sum#
$w.Sum(...numbers: number[]):number
功能描述#
计算一组数字的和
$w.Floor#
$w.Floor(number:number):number
功能描述#
返回传入数字向下取整的结果
示例#
$w.Floor(1.1); // 1$w.Floor(-1.1); // -2$w.Ceiling#
$w.Ceiling(number:number):number
功能描述#
返回传入数字向上取整的结果
示例#
$w.Ceiling(1.1); // 2$w.Ceiling(-1.1); // -1$w.Round#
$w.Round(number:number):number
功能描述#
返回传入数字四舍五入后的结果
$w.Rand#
$w.Rand(number:number):number
功能描述#
返回一个指定范围的伪随机整数
示例#
$w.Rand(10); // 2$w.Rand(-1); // 0$w.If#
$w.If(condition:boolean, consequent:any, alternate:any):any
$w.If(params: { condition:boolean; consequent:any; alternate:any}):any
功能描述#
按判断条件进行逻辑比较，满足时返回一个值，不满足时返回另一个值。
ps: 该函数包涵两种重载形式。其一接受一个参数列表，参数分别为
condition、consequent、alternate；其次只接受一个包涵以上三 key 的对象参数。除此之外两者并无任何不同。
入参#
condition:boolean#
判断条件
consequent:any#
满足时返回一个值
alternate:any#
不满足时返回另一个值
示例#
$w.If(1 == 1, "您好", "hello"); // "您好"$w.If({ condition: 1 == 1, consequent: "您好", alternate: "hello",}); // "您好"$w.IsEmpty#
$w.IsEmpty(text: string | string[]): boolean
功能描述#
判断输入值的字符是否为空，如果结果为数组类型，还会判断结果数组项是否全为空。
入参#
text: string | string[]#
要判断的值
示例#
$w.IsEmpty("text"); // false$w.IsEmpty(""); // true$w.IsEmpty(null); // false$w.IsEmpty(undefined); // false$w.IsEmpty(0); // false$w.NotNull#
功能描述#
$w.NotNull(val: any): boolean
判断传入的字段值是否不为 null
$w.And#
$w.And(...args: boolean[]): boolean
功能描述#
用于确定所有判断条件是否为真
$w.Or#
$w.Or(...args: boolean[]): boolean
功能描述#
任意一个判断条件为真，则结果为真；所有条件为否，结果才为否
$w.DateText#
$w.DateText(date:Timestamp, format:string): string
功能描述#
将格式化日期时间为指定格式的文本
入参#
date:Timestamp#
需要格式化的日期时间格式数据（毫秒数时间戳）。可以接受任意可以转换（通过 new Date 方法）成日期格式的数据
format:string#
格式模板。支持的占位符列表：
| 占位符 | 格式化输出 | 说明 |
|---|---|---|
YY | 18 | 两位数的年份 |
YYYY | 2018 | 四位数的年份 |
M | 1-12 | 月份，从 1 开始 |
MM | 01-12 | 月份，两位数 |
D | 1-31 | 月份里的一天 |
DD | 01-31 | 月份里的一天，两位数 |
d | 0-6 | 一周中的一天，星期天是 0 |
H | 0-23 | 小时 |
HH | 00-23 | 小时，两位数 |
m | 0-59 | 分钟 |
mm | 00-59 | 分钟，两位数 |
s | 0-59 | 秒 |
ss | 00-59 | 秒 两位数 |
SSS | 000-999 | 毫秒 三位数 |
Z | +05:00 | UTC 的偏移量，±HH:mm |
ZZ | +0500 | UTC 的偏移量，±HHmm |
出参#
string#
格式化后的日期时间字符串
示例#
$w.DateText(Date.now(), "yyyy-MM-dd HH:mm:ss"); //'2022-12-26 11:54:33'$w.DateTimeValue#
$w.DateTimeValue(dateString: string, format: string): number
功能描述#
将日期时间文本根据指定格式转化为日期时间，例如 DateTimeValue("2021-12-11 01:19:12", "yyyy-MM-dd HH:mm:ss")
入参#
dateString: string#
文本日期时间
format: string#
转换时间的格式
示例#
$w.DateTimeValue("2011-07-02", "YYYY:MM:DD"); // 1309536000000$w.Now#
$w.Now(): number
功能描述#
返回当前系统时间，通常与其他日期时间函数搭配使用
示例#
$w.Now(); // 1309536000000$w.GetDate#
$w.GetDate(year: number, month: number, day: number): number
功能描述#
根据输入的年月日数值返回一个日期类型的数据，例如 GetDate(2017,3,24)
入参#
year: number#
年
month: number#
月份，从 0 开始
day: number#
日
出参#
number#
返回的日期时间（数字毫秒时间戳）
$w.Timestamp#
$w.Timestamp(date: number | string | Date): number
功能描述#
根据输入的日期时间返回时间戳
入参#
date: number | string | Date#
需要转换的时间
出参#
number#
返回的时间戳
示例#
$w.Timestamp(new Date("2011-07-02")); // 1309564800000$w.Second#
$w.Second(date: number | string | Date): number
功能描述#
根据输入的日期时间返回该时间的秒数
入参#
date: number | string | Date#
需要获取的时间
出参#
number#
返回的秒数
示例#
$w.Second(new Date("2011-07-02")); //0$w.Minute#
$w.Minute(date: number | string | Date): number
功能描述#
根据输入的日期时间返回该时间的分钟部分
入参#
date: number | string | Date#
需要获取的时间
出参#
number#
返回的分钟数
示例#
$w.Minute(new Date("2011-07-02 12:22:32")); // 22$w.Hour#
$w.Hour(date: number | string | Date): number
功能描述#
根据输入的日期时间返回该时间的小时部分，24 小时制
入参#
date: number | string | Date#
需要获取的时间
出参#
number#
返回的小时数
示例#
$w.Hour(new Date("2011-07-02 12:22:32")); // 12$w.Day#
$w.Day(date: number | string | Date): number
功能描述#
根据输入的日期时间返回该时间的日部分，范围为 1-31
入参#
date: number | string | Date#
需要获取的时间
出参#
number#
返回的天数
示例#
$w.Day(new Date("2011-07-02")); // 2$w.DayOfWeek#
$w.DayOfWeek(date: number | string | Date): number
功能描述#
根据输入的日期时间返回该时间的星期数
入参#
date: number | string | Date#
需要获取的时间
出参#
number#
返回的星期数
示例#
$w.DayOfWeek(new Date("2011-07-02 12:22:32")); // 6$w.Month#
$w.Month(date: number | string | Date): number
功能描述#
根据输入的日期时间返回该时间的月份
入参#
date: number | string | Date#
需要获取的时间
出参#
number#
返回的月份
示例#
$w.Month(new Date("2011-07-02 12:22:32")); // 7$w.Year#
$w.Year(date: number | string | Date): number
功能描述#
根据输入的日期时间返回该时间的年份
入参#
date: number | string | Date#
需要获取的时间
出参#
number#
返回的年份
示例#
$w.Year(new Date("2011-07-02")); // 2011$w.Age#
$w.Age(date1: number | string | Date, date2: number | string | Date): number
功能描述#
根据输入的两个日期时间计算出年龄（按每年 365 天算出年份取整），例如 $w.Age($w.GetDate(2017, 3, 24), $w.GetDate(2021, 3, 24))。
入参#
date1: number | string | Date#
出生时间
date2: number | string | Date#
指定的计算时间
出参#
number#
返回的年龄
示例#
$w.Age($w.GetDate(2011, 6, 2), $w.GetDate(2012, 8, 2)); // 1$w.Age($w.GetDate(2011, 6, 2), $w.GetDate(2012, 5, 2)); // 0$w.AgeOfNow#
$w.AgeOfNow(date: number | string | Date): number
功能描述#
根据出生时间和当前时间计算年龄（按每年 365 天算出年份取整），例如 $w.AgeOfNow($w.GetDate(2017,3,24))。
满周岁才会加一岁
入参#
date: number | string | Date#
出生时间
出参#
number#
返回的年龄
示例#
$w.DateText($w.Now(), "YYYY-MM-DD"); // 假设今天是 2023-01-05$w.AgeOfNow($w.GetDate(2011, 6, 2)); // 11$w.AgeOfNow($w.GetDate(2012, 1, 4)); // 11$w.DateAdd#
$w.DateAdd(date: number | string | Date, days: number): number
功能描述#
在传入的日期时间上增加 X 天，支持负数
入参#
date: number | string | Date#
传入的日期
days: number#
增加的天数
出参#
number#
返回的日期
示例#
$w.DateAdd(1309536000000, 1); // 1309622400000$w.MonthAdd#
$w.MonthAdd(date: number | string | Date, months: number): number
功能描述#
在传入的日期和时间上增加 X 月，支持负数
入参#
date: number | string | Date#
传入的日期
months: number#
增加的月数
出参#
number#
返回的日期
示例#
$w.MonthAdd(1309536000000, 1); // 1312214400000$w.YearAdd#
$w.YearAdd(date: number | string | Date, years: number): number
功能描述#
在传入的日期和时间上增加 X 年，支持负数
入参#
date: number | string | Date#
传入的日期
years: number#
增加的年数
出参#
number#
返回的日期
示例#
$w.YearAdd(1309536000000, 1); // 1341158400000$w.YearDiff#
$w.YearDiff(startDate: number | string | Date, endDate: number | string | Date): number
功能描述#
返回两个日期时间字段之间的年数差，如果为同一年，差数为零
入参#
startDate: number | string | Date#
对比起始日期
endDate: number | string | Date#
对比终止日期
出参#
number#
返回的整数年数差
示例#
$w.YearDiff($w.GetDate(1980, 3, 24), $w.GetDate(1981, 3, 25)); // 1$w.MonthDiff#
$w.MonthDiff(startDate: number | string | Date, endDate: number | string | Date): number
功能描述#
返回两个日期时间字段之间的月数差，如果为同一月，差数为零
入参#
startDate: number | string | Date#
对比起始日期
endDate: number | string | Date#
对比终止日期
出参#
number#
返回的整数月数差
示例#
$w.MonthDiff($w.GetDate(1980, 3, 24), $w.GetDate(1981, 3, 25)); // 12$w.DateDiff#
$w.DateDiff(startDate: number | string | Date, endDate: number | string | Date): number
功能描述#
返回两个日期时间字段之间的天数差，如果为同一天，差数为零
入参#
startDate: number | string | Date#
对比起始日期
endDate: number | string | Date#
对比终止日期
出参#
number#
返回的整数天数差
示例#
$w.DateDiff($w.GetDate(1980, 3, 24), $w.GetDate(1981, 3, 25)); // 366$w.HourDiff#
$w.HourDiff(startDate: number | string | Date, endDate: number | string | Date): number
功能描述#
返回两个日期时间字段之间的小时差，如果为同一小时，差数为零
入参#
startDate: number | string | Date#
对比起始日期
endDate: number | string | Date#
对比终止日期
出参#
number#
返回的整数小时差
示例#
$w.HourDiff($w.GetDate(1980, 3, 24), $w.GetDate(1981, 3, 25)); // 8784$w.MinuteDiff#
$w.MinuteDiff(startDate: number | string | Date, endDate: number | string | Date): number
功能描述#
返回两个日期时间字段之间的分钟差，如果为同一分钟，差数为零
入参#
startDate: number | string | Date#
对比起始日期
endDate: number | string | Date#
对比终止日期
出参#
number#
返回的整数分钟差
示例#
$w.MinuteDiff($w.GetDate(1980, 3, 24), $w.GetDate(1980, 3, 25)); // 1440$w.SecondDiff#
$w.SecondDiff(startDate: number | string | Date, endDate: number | string | Date): number
功能描述#
返回两个日期时间字段之间的秒数差，如果为同一秒，差数为零
入参#
startDate: number | string | Date#
对比起始日期
endDate: number | string | Date#
对比终止日期
出参#
number#
返回的整数秒数差
示例#
$w.SecondDiff($w.GetDate(1980, 3, 24), $w.GetDate(1980, 3, 25)); // 86400$w.IsToday#
$w.IsToday(date: number | string | Date): boolean
功能描述#
判断传入的日期时间是否为今天，例如 $w.IsToday($w.GetDate(2022,4,8))
入参#
date: number | string | Date#
需判断的日期
出参#
boolean#
是否是今天的结果
示例#
$w.IsToday($w.GetDate(2021, 4, 8)); // false$w.Len#
$w.Len(text: string): number
功能描述#
获取传入文本的字符数。等同于 'text'.length
入参#
text: string#
需要计算的字符串
出参#
number#
字符串字符长度
示例#
$w.Len("微搭低代码"); // 5$w.Contains#
$w.Contains(text1: string, text2: string): boolean
功能描述#
判断文本 1 是否包含文本 2
入参#
text1: string#
文本 1。父字符串
text2: string#
文本 2。子字符串
出参#
boolean#
文本 1 是否包含文本 2
示例#
$w.Contains("1123123123", "12"); // true$w.Split#
$w.Contains(text: string, separator: string): string[]
功能描述#
根据传入的文本 2，将文本 1 拆分成文本数组，例如 $w.Split("张三,李四,王五", ",")
入参#
text: string#
需要被分割的字符串
separator: string#
分割符字符串
出参#
string[]#
分割后的字符串数组
示例#
$w.Split("您好,我的世界,我来了", ","); // ['您好','我的世界','我来了']$w.Trim#
$w.Trim(text: string): string
功能描述#
删除文本开头和结尾的所有空格和制表符，文本中间的空格和制表符不会删除
入参#
text: string#
需要处理的文本
出参#
string#
去掉首尾空格后的字符串
示例#
$w.Trim(" 微搭低代码 s "); // "微搭低代码 s"$w.Upper#
$w.Upper(text: string): string
功能描述#
将传入的字母转为全大写文本
入参#
text: string#
需要处理的文本
出参#
text: string#
转换后的文本
示例#
$w.Upper("abc"); // "ABC"$w.Lower#
$w.Lower(text: string): string
功能描述#
将传入的文本转为全小写文本
入参#
text: string#
需要处理的文本
出参#
text: string#
转换后的文本
示例#
$w.Lower("ABC"); // "abc"$w.Concat#
$w.Concat(...text: string[])
功能描述#
返回多个文本拼接后的新文本
入参#
...text: string[]#
出参#
string#
拼接的结果
示例#
$w.Concat("微搭", "低代码"); // 微搭低代码