附一 WynSql详解
功能概述
原生SQL查询是指某类型数据源能够接受的文本形式的查询语句，例如使用Oracle数据源时应使用符合Oracle查询语法的查询语句。
如果您的数据源是Excel, Csv, Json, Xml, MongoDB, OData，由于这些数据源原生的查询语法标准和标准SQL语法相差较大，Wyn为您提供了WynSql语言进行查询。
WynSql
WynSql是为查询Excel, Csv, Json, Xml, MongoDB, OData数据源提供的SQL查询语言。
WynSql基本模拟了SQLite语法标准但有以下限制：
只能使用SELECT语句。并且可以添加Limit 子句限制返回的行数，例如select * from Demo_订单明细 limit 5。
GroupBy子句中不能使用表达式，只能使用列引用。
OrderBy子句中不能使用表达式，只能使用列引用。
不能使用任何SQLite的内置函数，Wyn提供了自己的函数库。
WynSql函数库
注意
如果一个函数需要一个枚举值作为参数，请直接使用枚举值的字面值，不需要使用单/双引号。
例如StrLike(column1,'start%', Text)
函数 | 类型 | 语法 | 说明 |
|---|---|---|---|
Abs | 数学 | Abs(number) | 获取指定数值(number)的绝对值. |
Acos | 数学 | Acos(number) | 获取余弦值为指定数值(number)的角度(以弧度为单位)。 |
Asin | 数学 | Asin(number) | 获取正弦值为指定数值(number)的角度(以弧度为单位)。 |
Atan | 数学 | Atan(number) | 获取切线为指定数值(number)的角度(以弧度为单位)。 |
Atn2 | 数学 | Atn2(y, x) | 获取其切线为指定数值(x和y)的商的角度(以弧度为单位)。 |
Ceiling | 数学 | Ceiling(number) | 获取大于或等于指定数值(number)的最小整数。 |
Cos | 数学 | Cos(number) | 获取指定角度的余弦值。 |
Cot | 数学 | Cot(number) | 获取指定角度的三角余切值的角度(以弧度为单位)。 |
Degrees | 数学 | Degrees(radians) | 获取以弧度指定的角度(radians)的角度(以度为单位)。 |
Exp | 数学 | Exp(number) | 获取e的指定数值(number)的幂次方。 |
Floor | 数学 | Floor(number) | 获取小于或等于指定十进制数(number)的最大整数。 |
Log | 数学 | Log(number) | 获取(以e或指定数值newBase)为基数,指定数值(number)的自然对数。 |
Log10 | 数学 | Log10(number) | 获取以10为基数，指定数值(number)的自然对数。 |
PI | 数学 | PI() | 获取表示圆的圆周与其直径的比率,由常数π指定。 |
Power | 数学 | Power(x, y) | 获取指定数数值(x)的指定数值(y)的幂次方。 |
Radians | 数学 | Radians(degrees) | 获取以度为指定数值表达式(degress)的数值(以弧度为单位)。 |
Rand | 数学 | Rand() Rand(maxValue) | 获取指定范围内的随机整数, 或者获取一个大于等于0.0且小于1.0的随机浮点数。 |
Round | 数学 | Round(number) Round(number, digits) | 获取将舍入为最接近的整数或指定的小数位数. 可用的MidpointRounding枚举值: ToEven, AwayFromZero。 |
Sign | 数学 | Sign(number) | 获取一个数值符号(number)的整数。 -1：值小于零。 0：值等于零。 1：值大于零。 |
Sin | 数学 | Sin(number) | 获取指定角度(number)的正弦值。 |
Sqrt | 数学 | Sqrt(number) | 获取指定数值(number)的平方根。 |
Square | 数学 | Square(number) | 获取指定数值(number)的平方。 |
Tan | 数学 | Tan(number) | 获取指定角度(number)的正切值。 |
DateAdd | 日期时间 | DateAdd(EDatePart ddatepart, number, dateTime) | 获取将指定数值(number)作为有符号整数值添加到输入日期值(dateTime)的指定日期部分所产生的日期时间值.。可用的EDatePart枚举值： Year, yyyy, yy, Quarter, qq, q, Month, mm, m, DayOfYear, dy, y Day, dd, d, WeekDay, dw, Week, ww, wk, Hour, hh, Minute, mi, n, Second, ss, s, MilliSecond, ms |
DateDiff | 日期时间 | DateDiff(EDatePart datepart, dateTime1, dateTime2) | 获取指定日期(dateTime1)和(dateTime2)之间指定时间间隔(datepart)的数值(作为有符号整数值)、可用的EDatePart枚举值： Year, yyyy, yy, Quarter, qq, q, Month, mm, m, DayOfYear, dy, y Day, dd, d, WeekDay, dw, Week, ww, wk, Hour, hh, Minute, mi, n, Second, ss, s, MilliSecond, ms |
DateFromParts | 日期时间 | DateFromParts(year, month, day) | 获取指定年(year),月(month)和日(day)的日期值。 |
DatePart | 日期时间 | DatePart(EDatePart datepart, dateTime) | 获取指定日期(dateTime)的datepart的整数. 可用的EDatePart枚举值： Year, yyyy, yy, Quarter, qq, q, Month, mm, m, DayOfYear, dy, y Day, dd, d, WeekDay, dw, Week, ww, wk, Hour, hh, Minute, mi, n, Second, ss, s, MilliSecond, ms |
EOMonth | 日期时间 | EOMonth(dateTime, [int addMonth = 0]) | 获取包含具有可选偏移量的指定日期(dateTime)的月份的最后一天。 |
GetDate | 日期时间 | GetDate() | 获取当前系统时间戳，作为没有时区偏移的日期时间值。 |
GetUtcDate | 日期时间 | GetUTCDate() | 获取当前系统时间戳,作为UTC日期时间值而没有时区偏移量。 |
Concat | 文本 | Concat([string1,string2...]) | 获取给定字符串(string1,string2...)连接在一起生成的字符串。 |
Format | 文本 | Format(value, format) | 获取用指定格式(format)将指定值(value)格式化生成的字符串。 |
IndexOf | 文本 | IndexOf(value, search) | 获取从开头或指定位置(startIndex)开始，获取给定字符串(value)中子字符串(search)的位置。 |
IsNull | 文本 | IsNull(value) | 检查给定值(value)是否为null或DBNull；或者，如果指定值(value1)为null或DBNull，则获取备用值(value2)。 |
Left | 文本 | Left(value, length) | 获得从给定的字符串(value)中获取长度为(lengh)的子字符串(从左开始)。 |
Len | 文本 | Len(value) | 获取给定字符串(value)的长度。 |
Lower | 文本 | Lower(value) | 获取将给定字符串(value)中的所有字符转换为小写生成的字符串。 |
LTrim | 文本 | LTrim(value) | 获取从给定字符串(value)中删除所有前导空格生成的字符串。 |
Replace | 文本 | Replace(value, pattern, replacement) | 获取用字符(replacement)替换给定字符串(value)中的字符序列(pattern)生成的字符串。 |
Replicate | 文本 | Replicate(value, times) | 获取重复给定的字符串(value)指定的次数(times)生成的字符串。 |
Reverse | 文本 | REverse(value) | 获取反转给定字符串(value)生成的字符串。 |
Right | 文本 | Right(value, length) | 获得从给定的字符串(value)中获取长度为(lengh)的子字符串(从右开始)。 |
RTrim | 文本 | RTrim(value) | 获取从给定字符串(value)中删除所有尾随空格生成的字符串。 |
SubString | 文本 | SubString(value, startIndex, length) | 获取给定字符串(value)中从指定数值(startIndex)开始,提取长度为指定数值(length)子字符串。 |
ToString | 文本 | ToString(value) | 获取给定对象(value)的字符串。 |
Trim | 文本 | Trim(value) | 获取从给定字符串(value)中删除所有前导和尾随空格生成的字符串。 |
Upper | 文本 | Upper(value) | 获取将给定字符串(value)中的所有字符转换为大写字母生成的字符串。 |
Array | 混合 | Array([object1,object2...]) | 获取给定对象(object1,object2...)创建的数组。 |
Category | 混合 | Category(value, RangeOption rangeOption, OutsideRangeOption outsideRangeOption, min, max, step) | 获取表示指定值所在范围的文本。 可用的RangeOption枚举值：IncludeLeft_ExcludeRight, ExcludeLeft_IncludeRight.可用的OutsideRangeOption枚举值：None, LessThanMin, GreaterThanMax, All |
CustomCategory | 混合 | CustomCategory(value, RangeOption rangeOption, [categoryDefinition1, categoryDefinition2...]) | 获取一个文本,表示指定值所在的范围。可用的RangeOption枚举值：IncludeLeft_ExcludeRight, ExcludeLeft_IncludeRight。 |
FiscalYear | 混合 | FiscalYear(dateTime, startMonthOfFiscalYear) | 获取指定日期(dateTime)的财政年度。 |
Asc | 文本 | Asc(string) | 获取与字符对应的字符代码的Integer值。 |
AscW | 文本 | AscW(string) | 获取与Unicode字符对应的字符代码的Integer值。 |
Chr | 文本 | Chr(CharCode) | 获取与指定字符代码关联的字符。 |
ChrW | 文本 | ChrW(CharCode) | 获取与指定字符代码关联的Unicode字符。 |
Filter | 文本 | Filter([source1,source2...], Match, [bool Include = True], [CompareMethod Compare = Binary]) | 获取基于零的数组,该数组包含基于指定过滤条件的string数组的子集。可用的CompareMethod枚举值： Binary, Text。 |
FormatCurrency | 文本 | FormatCurrency(expression, [int NumDigitsAfterDecimal = -1], [TriState IncludeLeadingDigit = UseDefault], [TriState UseParensForNegativeNumbers = UseDefault], [TriState GroupDigits = UseDefault]) | 使用系统控制面板中定义的货币符号，获取格式为货币值的表达式。可用的TriState枚举值：True, False, UseDefault。 |
FormatDateTime | 文本 | FormatDateTime(expression, [DateFormat NamedFormat = GeneralDate]) | 获取表示日期/时间值的字符串表达式。可用的DateFormat枚举值：GeneralDate, LongDate, ShortDate, LongTime, ShortTime。 |
FormatNumber | 文本 | FormatNumber(expression, [int NumDigitsAfterDecimal = -1], [TriState IncludeLeadingDigit = UseDefault], [TriState UseParensForNegativeNumbers = UseDefault], [TriState GroupDigits = UseDefault]) | 获取格式为数值的表达式。可用的TriState枚举值：True, False, UseDefault。 |
FormatPercent | 文本 | FormatPercent(expression, numDigitsAfterDecimal = -1, TriState includeLeadingDigit = UseDefault, TriState useParensForNegativeNumbers = UseDefault, TriState groupDigits = TriState.UseDefault) | 获取格式为百分比(即乘以100)的表达式，其尾部为%字符。可用的TriState枚举值：True, False, UseDefault。 |
GetChar | 文本 | GetChar(str, Index) | 获取表示所提供字符串(str)中指定索引(Index)的字符。 |
InStr | 文本 | InStr(string1, string2, [CompareMethod Compare = Binary]) | 获取给定字符串string2)在字符串(string1)中第一次出现的起始位置。可用的CompareMethod枚举值: Binary, Text。 |
InStrRev | 文本 | InStrRev(stringCheck, stringMatch, [int start = -1], [CompareMethod compare = Binary]) | 获取第一次出现的字符串(stringCheck)在字符串(stringMatch)中的位置(从字符串的右侧开始)。可用的CompareMethod枚举值：Binary, Text. |
Join | 文本 | Join([source1,source2...], [string delimiter = " "]) | 获取通过连接数组中包含的多个子字符串(source1,source2...)创建的字符串。 |
LCase | 文本 | LCase(value) | 获取将给定字符串(value)转换为小写的字符串或字符。 |
LSet | 文本 | LSet(str, length) | 获取包含调整为指定长度(length)的字符串(str)左对齐的字符串。 |
Mid | 文本 | Mid(str, start) | 获取包含指定字符串(str)中从指定数值(start)开始,获取指定数量(length)字符的字符串。 |
RSet | 文本 | RSet(str, length) | 获取包含调整为指定长度(length)的字符串(str)的右对齐的字符串。 |
Space | 文本 | Space(number) | 获取由指定数量(number)的空格组成的字符串。 |
Split | 文本 | Split(str, [string delimiter = " "], [int limit = -1], [CompareMethod compare = Binary]) | 获取包含指定数量子字符串的从零开始的一维数组。 |
StrComp | 文本 | StrComp(string1, string2, [CompareMethod compare = Binary]) | 获取根据字符串比较的结果，返回-1,0或1。 |
StrDup | 文本 | StrDup(number, character) | 获取由指定字符(character)重复指定次数(number)组成的字符串或对象。 |
StrReverse | 文本 | StrReverse(str) | 获得将给定字符串(str)的字符顺序颠倒过来生成的字符串。 |
UCase | 文本 | UCase(str) | 获取将指定字符串(str)转换为大写的字符串或字符。 |
StrLike | 文本 | StrLike(str, pattern, CompareMethod compareOption) | 比较参数(str)和(pattern)并返回与Like运算符相同的结果。可用的CompareMethod枚举值： Binary, Text。 |
StrLikeText | 文本 | StrLikeText(str, Pattern) | 使用文本比较参数(str)和(pattern)并返回与Like运算符相同的结果。 |
StrLikeBinary | 文本 | StrLikeBinary(str, Pattern) | 使用二进制比较参数(str)和(pattern)并返回与Like运算符相同的结果。 |
DateSerial | 日期时间 | DateSerial(year, month, day) | 获取表示指定年(year)、月(month)和日(day)的日期值。 |
DateString | 日期时间 | DateString() | 根据您的系统返回表示当前日期的字符串。 |
DateValue | 日期时间 | DateValue(stringDate) | 获取包含字符串表示的日期信息的Date值，时间信息设置为凌晨(00:00:00)。 |
Day | 日期时间 | Day(dateValue) | 获取1到31之间的Integer值，表示该月的某天。 |
Hour | 日期时间 | Hour(timeValue) | 获取0到23之间的整数值，表示一天中的小时。 |
Minute | 日期时间 | Minute(timeValue) | 获取0到59之间的整数值，表示小时的分钟。 |
Month | 日期时间 | Month(dateValue) | 获取1到12之间的整数值，表示一年中的月份。 |
MonthName | 日期时间 | MonthName(month, [bool abbreviate = false]) | 获取包含指定月份month名称的字符串。 |
Now | 日期时间 | Now() | 根据您的系统返回包含当前日期和时间的日期值。 |
Second | 日期时间 | Second(timeValue) | 获取0到59之间的整数值，表示分钟的秒。 |
TimeOfDay | 日期时间 | TimeOfDay() | 根据您的系统返回或设置包含当前时间的日期值。 |
Timer | 日期时间 | Timer() | 获取自凌晨起经过的秒数。 |
TimeSerial | 日期时间 | TimeSerial(hour, minute, second) | 获取表示指定小时,分钟和秒的Date值，其中日期信息设置为相对于1年的1月1日。 |
TimeString | 日期时间 | TimeString() | 根据您的系统返回或设置表示当前时间的字符串。 |
TimeValue | 日期时间 | TimeValue(stringTime) | 获取包含字符串表示的时间信息的Date值，日期信息设置为1年1月1日。 |
Today | 日期时间 | Today() | 根据您的系统返回或设置包含当前日期的日期值。 |
Weekday | 日期时间 | Weekday(dateValue, [FirstDayOfWeek dayOfWeek = Sunday]) | 获取表示星期几的数值。可用的FirstDayOfWeek枚举值： System, Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday. |
WeekdayName | 日期时间 | WeekdayName(weekday, [bool abbreviate = false], [FirstDayOfWeek firstDayOfWeekValue = System]) | 获取包含指定工作日名称的字符串。可用的FirstDayOfWeek枚举值：System, Sunday, Monday,Tuesday, Wednesday, Thursday, Friday, Saturday. |
Year | 日期时间 | Year(dateValue) | 获取表示年份的1到9999之间的数值。 |
CBool | 类型转换 | CBool(value) | 将给定值(value)转换为'bool'类型。 |
CByte | 类型转换 | CByte(value) | 将给定值(value)转换为'byte'类型。 |
CChar | 类型转换 | CChar(value) | 将给定值(value)转换为'char'类型。 |
CDate | 类型转换 | CDate(value) | 将给定值(value)转换为'DateTime'类型。 |
CDbl | 类型转换 | CDbl(value) | 将给定值(value)转换为'double'类型。 |
CDec | 类型转换 | CDec(value) | 将给定值(value)转换为'decimal'类型。 |
CInt | 类型转换 | CInt(value) | 将给定值(value)转换为'int'类型。 |
CLng | 类型转换 | CLng(value) | 将给定值(value)转换为'long'类型。 |
CShort | 类型转换 | CShort(value) | 将给定值(value)转换为'short'类型。 |
CSng | 类型转换 | CSng(value) | 将给定值(value)转换为'float'类型。 |
CStr | 类型转换 | CStr(value) | 将给定值(value)转换为'string'类型。 |
Fix | 类型转换 | Fix(number) | 获取指定数值(number)的整数部分。Fix函数和Int函数的区别：Fix函数转换-8.4到-8，Int函数转换-8.4到-9。 |
Hex | 类型转换 | Hex(number) | 获取指定数值(number)的十六进制值的字符串。 |
Int | 类型转换 | Int(number) | 获取指定数值(number)的整数部分。Int和Fix之间的差异：Int将-8.4转换为-9，Fix将-8.4转换为-8。 |
Oct | 类型转换 | Oct(number) | 获取指定数值(number)的八进制值的字符串。 |
Str | 类型转换 | Str(number) | 获取指定数字(number)的字符串表示形式。始终为数字符号保留前导空格。 |
Val | 类型转换 | Val(expression) | 获取字符串中包含的数字作为适当类型的数值。 |
Rnd | 数学 | Rnd() | 获取Single类型的随机数。 |
Choose | 流程 | Choose(Index, [choice1,choice2...]) | 根据index的值从选择列表中返回一个值。如果index为1，则选择返回列表中的第一个选项；如果index为2，则返回第二个选择，依此类推。语法： Choose(index, choice-1 [, choice-2, ... [, choice-n ]] ) |
IIF | 流程 | IIF(expression, TruePart, FalsePart) | 获取两个对象中的一个，如果表达式的计算结果为真，则选择返回(TruePart)；否则返回(FalsePart)。 |
Switch | 流程 | Switch([varExpr1,varExpr2...]) | 计算表达式列表并返回与列表中第一个表达式相关联的值或表达式，该值为True。语法： Switch(expr-1, value-1 [ ,expr-2,value-2… [ ,expr-n,value-n ]] ) |
Partition | 流程 | Partition(Number, Start, Stop, Interval) | 获取指示在计算的一系列范围内出现数字的位置。您可以创建一个选择查询，显示有多少订单落在各种范围内。例如，订单值从1到1000，1001到2000，依此类推。 |
IsArray | 检测 | IsArray(exp) | 获取一个布尔值,指示变量(exp)是否为数组。 |
IsDate | 检测 | IsDate(exp) | 获取一个布尔值，如果表达式是日期或可识别为有效日期或时间，则返回True；反之，则返回False。 |
IsNothing | 检测 | IsNothing(exp) | 获取一个布尔值，指示表达式是否没有为其分配对象。 |
IsNumeric | 检测 | IsNumeric(exp) | 获取一个布尔值，指示是否可以将表达式计算为数字。 |
IsError | 检测 | IsError(exp) | 获取一个布尔值，指示是否可以将表达式计算为错误(exception)。 |
IsDBNull | 检测 | IsDBNull(exp) | 获取一个布尔值，指示对象是空值还是DBNull。 |
DDB | 财务 | DDB(Cost, Salvage, Life, Period, [double Factor = 2.0]) | 获取使用双倍余额递减法或您指定的其他方法指定特定时间段内资产的折旧。查看详细信息 https://msdn.microsoft.com/en-us/vba/language-reference-vba/articles/ddb-function。 |
FV | 财务 | FV(Rate, NPer, Pmt, [double PV = 0.0], [DueDate Due = EndOfPeriod]) | 获取指定基于定期，固定付款和固定利率的年金的未来价值。可用的DueDate枚举值： EndOfPeriod, BegOfPeriod。查看详细信息 https://msdn.microsoft.com/en-us/vba/language-reference-vba/articles/fv-function。 |
IPMT | 财务 | IPmt(Rate, Per, NPer, PV, [double FV = 0.0], [DueDate Due = EndOfPeriod]) | 获取指定基于定期固定付款和固定利率的特定年金期间的利息支付。可用的DueDate枚举值： EndOfPeriod, BegOfPeriod。查看详细信息 https://msdn.microsoft.com/en-us/vba/language-reference-vba/articles/ipmt-function。 |
NPER | 财务 | NPer(Rate, Pmt, PV, [double FV = 0.0], [DueDate Due = EndOfPeriod]) | 获取指定基于定期，固定付款和固定利率的年金的期数。可用的DueDate枚举值:：EndOfPeriod, BegOfPeriod。查看详细信息 https://msdn.microsoft.com/en-us/vba/language-reference-vba/articles/nper-function。 |
PMT | 财务 | Pmt(Rate, NPer, PV, [double FV = 0.0], [DueDate Due = EndOfPeriod)] | 获取指定基于定期固定付款和固定利率的年金付款。可用的DueDate枚举值： EndOfPeriod, BegOfPeriod。查看详细信息 https://msdn.microsoft.com/en-us/vba/language-reference-vba/articles/pmt-function。 |
PPMT | 财务 | PPmt(Rate, Per, NPer, PV, [double FV = 0.0], [DueDate Due = EndOfPeriod]) | 获取指定基于定期固定付款和固定利率的特定年金期间的本金。可用的DueDate枚举值： EndOfPeriod, BegOfPeriod。查看详细信息 https://msdn.microsoft.com/en-us/vba/language-reference-vba/articles/ppmt-function。 |
PV | 财务 | PV(Rate, NPer, Pmt, [double FV = 0.0], [DueDate Due = EndOfPeriod]) | 获取指定基于将来要支付的定期固定付款和固定利率的年金现值。可用的DueDate枚举值：EndOfPeriod, BegOfPeriod。查看详细信息 https://msdn.microsoft.com/en-us/vba/language-reference-vba/articles/pv-function。 |
RATE | 财务 | Rate(NPer, Pmt, PV, [double FV = 0.0], [DueDate Due = EndOfPeriod], [double Guess = 0.1]) | 获取指定年金的每个期间的利率。可用的DueDate枚举值：EndOfPeriod, BegOfPeriod。查看详细信息 https://msdn.microsoft.com/en-us/vba/language-reference-vba/articles/rate-function。 |
SLN | 财务 | SLN(Cost, Salvage, Life) | 获取指定单个期间资产的直线折旧。查看详细信息 https://msdn.microsoft.com/en-us/vba/language-reference-vba/articles/sln-function。 |
SYD | 财务 | SYD(Cost, Salvage, Life, Period) | 获取指定指定期间内资产的年数总和折旧。查看详细信息 https://msdn.microsoft.com/en-us/vba/language-reference-vba/articles/syd-function。 |
其他
Case...When
在 WynSql 语句中支持使用 Case...when 语法，用来判断条件列表并返回多个可能的结果之一。
支持两种格式，以下分别进行说明并举例。
格式一：通过将一个表达式与一组简单表达式进行比较来确定结果
语法：
CASE input_expression
WHEN when_expression THEN result_expression [ ...n ]
[ ELSE else_result_expression ]
END示例：
Case 类别名称
WHEN '生鲜蔬果' THEN '食品'
WHEN '饮料烟酒' THEN '食品'
WHEN '食品副食' THEN '食品'
WHEN '日用百货' THEN '百货'
WHEN '文体办公' THEN '百货'
ELSE '其它'
END as category格式二：通过对一组布尔表达式求值来确定结果
语法：
CASE
WHEN Boolean_expression THEN result_expression [ ...n ]
[ ELSE else_result_expression ]
END示例：
CASE
WHEN 产品单价<100 THEN 'Under 100'
WHEN 产品单价>=100 AND 产品单价<1000 THEN 'Under 1000'
ELSE 'Over 1000'
END as 产品单价分组type=info
提示
Case...when 语法中不支持嵌套子查询，使用时需留意。