你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
将所请求的日期部分提取为整数值。
弃用的别名：datepart()
语法
datetime_part(
部分,datetime)
详细了解语法约定。
参数
| 客户 | 类型 | 必需 | 描述 |
|---|---|---|---|
| 部分 | string |
✔️ | 要从 date 中提取的时间的度量。 请参阅可能的值。 |
| 日期 | datetime |
✔️ | 要从中提取 part 的完整日期。 |
part 的可能值
- 年份
- 季度
- 月份
- week_of_year
- 日期
- DayOfYear
- 小时
- 分钟
- 第二个
- 毫秒
- 微秒
- 纳秒
返回
返回一个整数，表示提取的部件。
注意
week_of_year 返回一个表示周数的整数。 周数从一年的第一周算起，该周包括第一个周四。
例子
以下示例从指定的日期/时间值中提取年份、季度、月、年、日、小时、分钟、秒、毫秒、微秒和纳秒。
let dt = datetime(2017-10-30 01:02:03.7654321);
print
year = datetime_part("year", dt),
quarter = datetime_part("quarter", dt),
month = datetime_part("month", dt),
weekOfYear = datetime_part("week_of_year", dt),
day = datetime_part("day", dt),
dayOfYear = datetime_part("dayOfYear", dt),
hour = datetime_part("hour", dt),
minute = datetime_part("minute", dt),
second = datetime_part("second", dt),
millisecond = datetime_part("millisecond", dt),
microsecond = datetime_part("microsecond", dt),
nanosecond = datetime_part("nanosecond", dt)
输出
| 年 | 季度 | 月份 | weekOfYear | 日 | dayOfYear | 小时 | 分钟 | 第 2 个 | 毫秒 | 微秒 | 纳秒 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 2017 | 4 | 10 | 44 | 30 | 303 | 1 | 2 | 3 | 765 | 765432 | 765432100 |
注意
weekofyear 是 week_of_year 部分的已过时变体。
weekofyear 不符合 ISO 8601；一年的第一周被定义为一年中包含第一个周三的那一周。
week_of_year 符合 ISO 8601；一年的第一周被定义为一年中包含第一个周四的那一周。 [有关详细信息]，请参阅 ISO 8601 周日期。