跳到主要内容

函数表达式

$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​

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

占位符格式化输出说明
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("微搭", "低代码"); // 微搭低代码