跳到主要内容

函数表达式

$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: 该函数包涵两种重载形式。其一接受一个参数列表,参数分别为 conditionconsequentalternate;其次只接受一个包涵以上三 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

格式模板。支持的占位符列表:

占位符格式化输出说明
YY18两位数的年份
YYYY2018四位数的年份
M1-12月份,从 1 开始
MM01-12月份,两位数
D1-31月份里的一天
DD01-31月份里的一天,两位数
d0-6一周中的一天,星期天是 0
H0-23小时
HH00-23小时,两位数
m0-59分钟
mm00-59分钟,两位数
s0-59
ss00-59秒 两位数
SSS000-999毫秒 三位数
Z+05:00UTC 的偏移量,±HH:mm
ZZ+0500UTC 的偏移量,±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.TimeText

$w.TimeText(time:number, format:string): string

功能描述

格式化时间为指定格式的文本

入参

time:number

需要格式化的时间,单位为ms,是通过(小时 60 60 + 分钟 60) 1000计算而来

format:string

格式模板。支持的占位符列表:

占位符格式化输出说明
H0-23小时
HH00-23小时,两位数
m0-59分钟
mm00-59分钟,两位数
s0-59
ss00-59秒 两位数
SSS000-999毫秒 三位数

出参

string

格式化后的时间字符串

示例

$w.TimeText(28800000, 'HH:mm'); //'08:00'

$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("微搭", "低代码"); // 微搭低代码