函数表达式
#
$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("微搭", "低代码"); // 微搭低代码