第四十一章 SQL函数 DATE

2023-10-28 02:50

本文主要是介绍第四十一章 SQL函数 DATE,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

文章目录

  • 第四十一章 SQL函数 DATE
  • 大纲
  • 参数
  • 描述
  • $HOROLOG 与 $ZTIMESTAMP
  • ODBC日期字符串
  • 示例

第四十一章 SQL函数 DATE

接受时间戳并返回日期的函数。

大纲

DATE(timestamp)

参数

  • timestamp - 指定时间戳或其他日期或日期和时间表示形式的表达式。

描述

Date接受时间戳表达式并返回日期。返回值的数据类型为Date。这在功能上与CAST相同(时间戳与日期相同)。它接受具有以下任何数据类型类(或其子类)的时间戳值:%Library.TimeStamp%Library.PosiTime%Library.Date%Library.Integer%Library.Numerical(用于隐式逻辑日期,如+$HOROLOG)。它还可以接受格式与%Library.TimeStamp(有效的ODBC日期)兼容的%Library.String值。

无效的ODBC日期字符串的计算结果为零,与日期1840年12月31日相对应。时间戳可以只包含ODBC格式的日期或ODBC格式的日期和时间。虽然只转换ODBC时间戳的日期部分,但会验证整个字符串。如果日期部分不完整、日期或时间部分包含超出范围的值(包括闰年计算),或者时间戳包含任何无效的格式字符或尾随字符,则ODBC时间戳验证失败。

空字符串(‘’)参数返回0(1840年12月31日)。NULL参数返回NULL

这个函数也可以从ObjectScript中使用DATE()方法调用来调用:

DHC-APP>  WRITE $SYSTEM.SQL.DATE("2018-02-23 12:37:45")
64702

$HOROLOG 与 $ZTIMESTAMP

$HOROLOG$ZTIMESTAMP返回字符串值。
当字符串被转换为数字类型时,它总是返回一个数字值0(0)。0的 IRIS DATE数据类型值是1840年12月31日

因此,为了将$HOROLOG$ZTIMESTAMP解释为当前日期,必须在它前面加上一个加号(+),这将强制进行数字解释。
如下示例所示:

SELECT DATE($HOROLOG),DATE($ZTIMESTAMP)  

在这里插入图片描述

SELECT DATE(+$HOROLOG),DATE(+$ZTIMESTAMP)  

在这里插入图片描述

ODBC日期字符串

DATE函数和$SYSTEM.SQL.DATE()方法都可以接受ODBC日期格式字符串。
它们验证输入字符串。
如果通过验证,则返回相应的日期。
如果验证失败,则返回0。
验证过程如下:

  • 必须对应于ODBC格式:yyyy-mm-dd hh:mm:ss.xx
    整个字符串将被解析以获得正确的格式,而不仅仅是字符串的日期部分。
  • 字符串必须包含(至少)完整的日期:yyyy-mm-dd
    前导零可以省略或包括。
    时间部分为可选,可以包括yyyy-mm-dd hh:
  • 字符串的每个数字元素(包括日期部分和时间部分)都必须包含一个有效值。
    例如,月的取值范围为1 ~ 12(包括1 ~ 12)。
    日值不能超过指定月份的天数。
    闰年的天数是计算出来的。
  • 日期必须在%Library.TimeStamp日期范围内。最小日期为0001-01-01,最大日期为9999-12-31

示例

以下示例采用数据类型%Library.TimeStamp的值:

/// d ##class(PHA.TEST.SQLCommand).Date()
ClassMethod Date()
{s myquery = "SELECT {fn NOW} AS NowCol,DATE({fn NOW}) AS DateCol"s tStatement = ##class(%SQL.Statement).%New()s qStatus = tStatement.%Prepare(myquery)if qStatus'=1 {WRITE "%Prepare failed:" DO $System.Status.DisplayError(qStatus) QUIT}s rset = tStatement.%Execute()d rset.%Display()
}
DHC-APP>d ##class(PHA.TEST.SQLCommand).Date()
NowCol  DateCol
2022-02-02 10:29:48     661421 Rows(s) Affected
ClassMethod Date1()
{s myquery = "SELECT CURRENT_TIMESTAMP AS TSCol,DATE(CURRENT_TIMESTAMP) AS DateCol"s tStatement = ##class(%SQL.Statement).%New()s qStatus = tStatement.%Prepare(myquery)s rset = tStatement.%Execute()d rset.%Display()
}
DHC-APP> d ##class(PHA.TEST.SQLCommand).Date1()
TSCol   DateCol
2022-02-02 10:30:40     661421 Rows(s) Affected
/// d ##class(PHA.TEST.SQLCommand).Date2()
ClassMethod Date2()
{s myquery = "SELECT GETDATE() AS GetDateCol,DATE(GETDATE()) AS DateCol"s tStatement = ##class(%SQL.Statement).%New()s qStatus = tStatement.%Prepare(myquery)s rset = tStatement.%Execute()d rset.%Display()
}
DHC-APP>d ##class(PHA.TEST.SQLCommand).Date2()
GetDateCol      DateCol
2022-02-02 10:31:31     661421 Rows(s) Affected

下面的示例采用%Library.TimeStamp格式的字符串值:

ClassMethod Date3()
{s myquery = "SELECT '2018-02-22 13:14:23' AS DateStrCol,DATE('2018-02-22 13:14:23') AS DateCol"s tStatement = ##class(%SQL.Statement).%New()s qStatus = tStatement.%Prepare(myquery)s rset = tStatement.%Execute()d rset.%Display()
}
DHC-APP>d ##class(PHA.TEST.SQLCommand).Date3()
DateStrCol      DateCol
2018-02-22 13:14:23     647011 Rows(s) Affected

以下示例采用以 IRIS逻辑格式表示日期的字符串值。为了将这些值正确转换为%Library.Date数据类型,该值必须以加号(+)为前缀,以强制进行数值计算:

ClassMethod Date4()
{s myquery = "SELECT $H AS HoroCol,DATE(+$H) AS DateCol"s tStatement = ##class(%SQL.Statement).%New()s qStatus = tStatement.%Prepare(myquery)s rset = tStatement.%Execute()d rset.%Display()
}
DHC-APP> d ##class(PHA.TEST.SQLCommand).Date4()
HoroCol DateCol
66142,38015     661421 Rows(s) Affected
/// d ##class(PHA.TEST.SQLCommand).Date5()
ClassMethod Date5()
{s myquery = "SELECT $ZTIMESTAMP AS TSCol,DATE(+$ZTIMESTAMP) AS DateCol"s tStatement = ##class(%SQL.Statement).%New()s qStatus = tStatement.%Prepare(myquery)s rset = tStatement.%Execute()d rset.%Display()
}
DHC-APP>d ##class(PHA.TEST.SQLCommand).Date5()
TSCol   DateCol
66142,9262.279  661421 Rows(s) Affected

这篇关于第四十一章 SQL函数 DATE的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/290197

相关文章

C++中assign函数的使用

《C++中assign函数的使用》在C++标准模板库中,std::list等容器都提供了assign成员函数,它比操作符更灵活,支持多种初始化方式,下面就来介绍一下assign的用法,具有一定的参考价... 目录​1.assign的基本功能​​语法​2. 具体用法示例​​​(1) 填充n个相同值​​(2)

MySql基本查询之表的增删查改+聚合函数案例详解

《MySql基本查询之表的增删查改+聚合函数案例详解》本文详解SQL的CURD操作INSERT用于数据插入(单行/多行及冲突处理),SELECT实现数据检索(列选择、条件过滤、排序分页),UPDATE... 目录一、Create1.1 单行数据 + 全列插入1.2 多行数据 + 指定列插入1.3 插入否则更

MySQL深分页进行性能优化的常见方法

《MySQL深分页进行性能优化的常见方法》在Web应用中,分页查询是数据库操作中的常见需求,然而,在面对大型数据集时,深分页(deeppagination)却成为了性能优化的一个挑战,在本文中,我们将... 目录引言:深分页,真的只是“翻页慢”那么简单吗?一、背景介绍二、深分页的性能问题三、业务场景分析四、

MySQL 迁移至 Doris 最佳实践方案(最新整理)

《MySQL迁移至Doris最佳实践方案(最新整理)》本文将深入剖析三种经过实践验证的MySQL迁移至Doris的最佳方案,涵盖全量迁移、增量同步、混合迁移以及基于CDC(ChangeData... 目录一、China编程JDBC Catalog 联邦查询方案(适合跨库实时查询)1. 方案概述2. 环境要求3.

PostgreSQL中rank()窗口函数实用指南与示例

《PostgreSQL中rank()窗口函数实用指南与示例》在数据分析和数据库管理中,经常需要对数据进行排名操作,PostgreSQL提供了强大的窗口函数rank(),可以方便地对结果集中的行进行排名... 目录一、rank()函数简介二、基础示例:部门内员工薪资排名示例数据排名查询三、高级应用示例1. 每

SQL server数据库如何下载和安装

《SQLserver数据库如何下载和安装》本文指导如何下载安装SQLServer2022评估版及SSMS工具,涵盖安装配置、连接字符串设置、C#连接数据库方法和安全注意事项,如混合验证、参数化查... 目录第一步:打开官网下载对应文件第二步:程序安装配置第三部:安装工具SQL Server Manageme

C#连接SQL server数据库命令的基本步骤

《C#连接SQLserver数据库命令的基本步骤》文章讲解了连接SQLServer数据库的步骤,包括引入命名空间、构建连接字符串、使用SqlConnection和SqlCommand执行SQL操作,... 目录建议配合使用:如何下载和安装SQL server数据库-CSDN博客1. 引入必要的命名空间2.

全面掌握 SQL 中的 DATEDIFF函数及用法最佳实践

《全面掌握SQL中的DATEDIFF函数及用法最佳实践》本文解析DATEDIFF在不同数据库中的差异,强调其边界计算原理,探讨应用场景及陷阱,推荐根据需求选择TIMESTAMPDIFF或inte... 目录1. 核心概念:DATEDIFF 究竟在计算什么?2. 主流数据库中的 DATEDIFF 实现2.1

MySQL 多列 IN 查询之语法、性能与实战技巧(最新整理)

《MySQL多列IN查询之语法、性能与实战技巧(最新整理)》本文详解MySQL多列IN查询,对比传统OR写法,强调其简洁高效,适合批量匹配复合键,通过联合索引、分批次优化提升性能,兼容多种数据库... 目录一、基础语法:多列 IN 的两种写法1. 直接值列表2. 子查询二、对比传统 OR 的写法三、性能分析

MySQL中的LENGTH()函数用法详解与实例分析

《MySQL中的LENGTH()函数用法详解与实例分析》MySQLLENGTH()函数用于计算字符串的字节长度,区别于CHAR_LENGTH()的字符长度,适用于多字节字符集(如UTF-8)的数据验证... 目录1. LENGTH()函数的基本语法2. LENGTH()函数的返回值2.1 示例1:计算字符串