對應資料流中的日期和時間函數
適用於：
Azure Data Factory Azure Synapse Analytics
提示
試用 Microsoft Fabric 中的 Data Factory，這是適用於企業的全方位分析解決方案。 Microsoft Fabric 涵蓋從資料移動到資料科學、即時分析、商業智慧和報告的所有項目。 了解如何免費啟動新的試用版！
Azure Data Factory 和 Azure Synapse Pipelines 中均可使用資料流。 本文適用於對應資料流。 如果您不熟悉轉換作業，請參閱簡介文章使用對應資料流轉換資料。
下列文章提供對應資料流中 Azure Data Factory 和 Azure Synapse Analytics 支援的日期和時間函數詳細資料。
運算式函式清單
在 Data Factory 和 Synapse 管線中，使用日期和時間函數來表示 datetime 值並加以操作。
| 運算式函數 | Task |
|---|---|
| add | 新增一對字串或數字。 將日期新增至天數。 將持續時間新增至時間戳記。 對某個陣列附加類似類型的另一個陣列。 相當於 + 運算子。 |
| addDays | 在日期或時間戳記中增加天數。 相當於日期的 + 運算子。 |
| addMonths | 在日期或時間戳記中增加月數。 您可以選擇性地傳遞時區。 |
| between | 檢查第一個值是否內含在兩個其他值之間。 可以比較數值、字串和日期時間值 |
| currentDate | 在此作業開始執行時取得目前的日期。 您可以用 'GMT'、'PST'、'UTC'、'America/Cayman' 的格式傳遞選擇性的時區。 當地時區會作為預設值。 請參閱 Java 的 SimpleDateFormat 類別，以了解可用的格式。 https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html. |
| currentTimestamp | 在作業開始執行時，以當地時區為準取得目前的時間戳記。 |
| currentUTC | 取得 UTC 格式的目前時間戳記。 如果您想要將目前時間轉譯成與您的叢集時區不同的時區，可以用 'GMT'、'PST'、'UTC' 或 'America/Cayman' 的格式傳遞選擇性時區。 其預設值為目前的時區。 請參閱 Java 的 SimpleDateFormat 類別，以了解可用的格式。 https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html. 若要將 UTC 時間轉換成不同的時區，請使用 fromUTC()。 |
| dayOfMonth | 取得指定日期是當月第幾天。 |
| dayOfWeek | 取得指定日期的星期日期。 1 - 星期日、2 - 星期一...、7 - 星期六。 |
| dayOfYear | 取得指定日期是當年第幾天。 |
| days | 天數的持續時間 (以毫秒為單位)。 |
| fromUTC | 從 UTC 轉換成時間戳記。 您可以用 'GMT'、'PST'、'UTC'、'America/Cayman' 的形式選擇性傳遞時區。 其預設值為目前的時區。 請參閱 Java 的 SimpleDateFormat 類別，以了解可用的格式。 https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html. |
| hour | 取得時間戳記的小時值。 您可以用 'GMT'、'PST'、'UTC'、'America/Cayman' 的格式傳遞選擇性的時區。 當地時區會作為預設值。 請參閱 Java 的 SimpleDateFormat 類別，以了解可用的格式。 https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html. |
| hours | 時數的持續時間 (以毫秒為單位)。 |
| isDate | 檢查輸入日期字串是否為使用選用輸入日期格式的日期。 如需可用的格式，請參閱 Java 的 SimpleDateFormat。 如果省略輸入日期格式，則預設格式為 yyyy-[M]M-[d]d。 接受的格式為 [ yyyy, yyyy-[M]M, yyyy-[M]M-[d]d, yyyy-[M]M-[d]dT* ] |
| isTimestamp | 檢查輸入日期字串是否為使用選用輸入時間戳記格式的時間戳記。 如需可用的格式，請參閱 Java 的 SimpleDateFormat。 如果省略時間戳記，則會使用預設模式 yyyy-[M]M-[d]d hh:mm:ss[.f...]。 您可以用 'GMT'、'PST'、'UTC'、'America/Cayman' 的格式傳遞選擇性的時區。 時間戳記支援的精確度高達毫秒，值為 999。請參閱 Java 的 SimpleDateFormat，了解可用的格式。 |
| lastDayOfMonth | 取得指定日期的當月最後一個日期。 |
| millisecond | 取得日期的毫秒值。 您可以用 'GMT'、'PST'、'UTC'、'America/Cayman' 的格式傳遞選擇性的時區。 當地時區會作為預設值。 請參閱 Java 的 SimpleDateFormat 類別，以了解可用的格式。 https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html. |
| milliseconds | 毫秒數的持續時間 (以毫秒為單位)。 |
| minus | 減去數字。 從日期中減去天數。 從時間戳記減去持續時間。 減去兩個時間戳記來取得差異 (以毫秒為單位)。 相當於 - 運算子。 |
| minute | 取得時間戳記的分鐘值。 您可以用 'GMT'、'PST'、'UTC'、'America/Cayman' 的格式傳遞選擇性的時區。 當地時區會作為預設值。 請參閱 Java 的 SimpleDateFormat 類別，以了解可用的格式。 https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html. |
| 分鐘 | 分鐘數的持續時間 (以毫秒為單位)。 |
| month | 取得日期或時間戳記的月份值。 |
| monthsBetween | 取得兩個日期之間的月數。 您可以四捨五入計算。 您可以用 'GMT'、'PST'、'UTC'、'America/Cayman' 的格式傳遞選擇性的時區。 當地時區會作為預設值。 請參閱 Java 的 SimpleDateFormat 類別，以了解可用的格式。 https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html. |
| second | 取得日期的秒值。 您可以用 'GMT'、'PST'、'UTC'、'America/Cayman' 的格式傳遞選擇性的時區。 當地時區會作為預設值。 請參閱 Java 的 SimpleDateFormat 類別，以了解可用的格式。 https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html. |
| seconds | 秒數的持續時間 (以毫秒為單位)。 |
| subDays | 從日期或時間戳記中減去天數。 相當於日期的 - 運算子。 |
| subMonths | 從日期或時間戳記中減去月數。 |
| toDate | 使用選擇性輸入日期格式，將輸入日期字串轉換為日期。 請參閱 Java 的 SimpleDateFormat 類別，以了解可用的格式。 如果省略輸入日期格式，則預設格式為 yyyy-[M]M-[d]d。 接受的格式為：[ yyyy, yyyy-[M]M, yyyy-[M]M-[d]d, yyyy-[M]M-[d]dT* ]。 |
| toTimestamp | 以指定的選擇性時間戳記格式將字串轉換為時間戳記。 如果省略時間戳記，則會使用預設模式 yyyy-[M]M-[d]d hh:mm:ss[.f...]。 您可以用 'GMT'、'PST'、'UTC'、'America/Cayman' 的格式傳遞選擇性的時區。 時間戳記支援的精確度高達毫秒，值為 999。 請參閱 Java 的 SimpleDateFormat 類別，以了解可用的格式。 https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html. |
| toUTC | 將時間戳記轉換為 UTC。 您可以用 'GMT'、'PST'、'UTC'、'America/Cayman' 的格式傳遞選擇性的時區。 其預設值為目前的時區。 請參閱 Java 的 SimpleDateFormat 類別，以了解可用的格式。 https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html. |
| weekOfYear | 取得指定日期的年中周次。 |
| weeks | 週數的持續時間 (以毫秒為單位)。 |
| year | 取得日期的年份值。 |