將要求的日期部分擷取為整數值。
已被取代的別名： datepart（）
語法
datetime_part(
部分,datetime)
深入瞭解 語法慣例。
參數
| 姓名 | 類型 | 必要 | 描述 |
|---|---|---|---|
| 部分 | string |
✔️ | 測量要從日期擷取的時間。 請參閱 可能的值。 |
| 日期 | datetime |
✔️ | 要從中擷取 元件的完整日期。 |
部分的可能值
- 年
- 季
- 月
- week_of_year
- 日
- 年中的某一天
- 小時
- 分鐘
- 第二個
- 毫秒
- 微秒
- 奈秒
傳回
傳回整數，表示擷取的元件。
注意
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 | 天 | 年中的某一天 | 小時 | 分鐘 | 秒 | 毫秒 | 微秒 | 納秒 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 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 周日期。