# 日期與時間函數

Qlik Sense 日期和時間函數用於轉換日期和時間值。所有函數皆可用於資料載入指令碼和圖表運算式。

函數以相當於從 1899 年 12 月 30 日起算的天數的日期時間序號為基礎。整數值代表天，分數值代表當天的時間。

Qlik Sense 使用參數的數值，以便當數字的格式未設定為日期或時間時，作為參數也有效。如果參數未對應於數值，例如，因為它是字串，則 Qlik Sense 會嘗試根據日期和時間環境變數來解譯字串。

如果參數中所用的時間格式未對應於環境變數中設定的時間格式，Qlik Sense 將無法正確解譯。若要解決這個問題，可變更設定或使用解譯函數。

在每一個函數的範例中，假設預設時間與日期格式是 hh:mm:ss 和 YYYY-MM-DD (ISO 8601)。

資訊備註

使用日期或時間函數處理時間戳記時，Qlik Sense 會忽略任何日光節約時間參數，除非日期或時間函數包括地理位置。

例如，`ConvertToLocalTime( filetime('Time.qvd'), 'Paris')` 會使用日光節約時間參數，而 `ConvertToLocalTime(filetime('Time.qvd'), 'GMT-01:00')` 則不會使用日光節約時間參數。

使用每個函數中的下拉式功能表，以查看每個函數的簡要描述及語法。按一下語法描述中的函數名稱，以取得進一步詳細資料。

### 時間的整數運算式

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### second

當 expression 的分數根據標準數字解譯的方式可解譯為時間時，此函數會傳回代表秒的整數。

[**second**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/second.htm)(expression)

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### minute

當 expression 的分數根據標準數字解譯的方式可解譯為時間時，此函數會傳回代表分鐘的整數。

[**minute**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/minute.htm)(expression)

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### hour

當 expression 的分數根據標準數字解譯的方式可解譯為時間時，此函數會傳回代表小時的整數。

[**hour**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/hour.htm)(expression)

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### day

當 expression 的分數根據標準數字解譯的方式可解譯為日期時，此函數會傳回代表日的整數。

[**day**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/day.htm)(expression)

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### week

此函數會傳回根據 ISO 8601 代表週數的整數。週數是根據標準數字解譯，從運算式的日期解譯計算所得。

[**week**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/week.htm)(expression)

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### month

此函數會傳回雙值：一個如環境變數 MonthNames 中所定義的月份名稱，一個介於 1 與 12 之間的整數。月份是根據標準數字解譯，從運算式的日期解譯計算所得。

[**month**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/month.htm)(expression)

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### year

當 expression 根據標準數字解譯的方式可解譯為日期時，此函數會傳回代表年份的整數。

[**year**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/year.htm)(expression)

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### weekyear

此函數會根據環境變數傳回週數所屬於的年份。週數的範圍介於 1 和約 52 之間。

[**weekyear**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/weekyear.htm)(expression)

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### weekday

此函數會傳回函下列項目的雙值：

* 如環境變數 DayNames 中所定義的日名稱。
* 介於 0 至 6 之間且對應於一週中正常日 (0-6) 的整數。

[**weekday**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/weekday.htm)(date)

### Timestamp 函數

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### now

此函數會傳回目前時間的時間戳記。 該函數會傳回 TimeStamp 系統變數格式的值。預設 timer\_mode 值為 1。

[**now**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/now.htm)([ timer\_mode])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### today

此函數會傳回目前日期。該函數會以 `DateFormat` 系統變數格式傳回值。

[**today**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/today.htm)([timer\_mode])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### LocalTime

此函數會傳回指定時區目前時間的時間戳記。

[**localtime**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/localtime.htm)([timezone [, ignoreDST ]])

### Make 函數

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### makedate

此函數會傳回從年 YYYY、月 MM 及日 DD 計算而得的日期。

[**makedate**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/makedate.htm)(YYYY [ , MM [ , DD ] ])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### makeweekdate

此函數會傳回從年、週數及星期幾計算而得的日期。

[**makeweekdate**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/makeweekdate.htm)(YYYY [ , WW [ , D ] ])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### maketime

此函數會傳回從小時 hh、分鐘 mm 及秒 ss 計算而得的時間。

[**maketime**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/maketime.htm)(hh [ , mm [ , ss [ .fff ] ] ])

### Other date 函數

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### AddMonths

此函數會傳回 startdate 後 n 個月的日期，或者如果 n 是負數，則傳回 startdate 之前 n 個月的日期。

[**addmonths**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/addmonths.htm)(startdate, n , [ , mode])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### AddYears

此函數會傳回 startdate 後 n 年的日期，或者如果 n 是負數，則傳回 startdate 之前 n 年的日期。

[**addyears**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/addyears.htm)(startdate, n)

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### yeartodate

此功能會尋找輸入時間戳記是否位於前次載入指令碼之日期的年份內，並傳回 True (如果在其內)，False (如果不在其內)。

[**yeartodate**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yeartodate.htm)(date [ , yearoffset [ , firstmonth [ , todaydate] ] ])

### Timezone 函數

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### timezone

此函數傳回時區，如執行 Qlik 引擎的電腦上所定義。

[**timezone**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/timezone.htm)( )

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### GMT

此函數會傳回目前 Greenwich Mean Time，如衍生自區域設定。

[**GMT**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/GMT.htm)( )

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### UTC

傳回目前 Coordinated Universal Time。

[**UTC**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/UTC.htm)( )

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### daylightsaving

傳回目前針對日光節約時間所作的調整 (如 Windows 所定義)。

[**daylightsaving**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/daylightsaving.htm)( )

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### converttolocaltime

將 UTC 或 GMT 時間戳記轉換為當地時間作為雙值。其中 place 可為全世界任何一個城市、地點及時區。

[**converttolocaltime**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/converttolocaltime.htm)(timestamp [, place [, ignore\_dst=false]])

### Set time 函數

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### setdateyear

此函數會輸入 timestamp 與 year ，並使用輸入中指定的 year 更新 timestamp 。

[**setdateyear**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/setdateyear.htm) (timestamp, year)

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### setdateyearmonth

此函數會輸入 timestamp、month 與 year ，並使用輸入中指定的 year 和 month 更新 timestamp 。

[**setdateyearmonth**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/setdateyearmonth.htm) (timestamp, year, month)

### In... 函數

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### inyear

此函數會傳回 True，前提是如果 timestamp 位於包含 base\_date 的年中。

[**inyear**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inyear.htm)(date, basedate , shift [, first\_month\_of\_year = 1])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### inyeartodate

如果 timestamp 位於包含 base\_date 的年部分內，且不超過 (可包含) base\_date 的最後一毫秒，則此函數會傳回 True。

[**inyeartodate**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inyeartodate.htm) (date, basedate , shift [, first\_month\_of\_year = 1])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### inquarter

此函數會傳回 True，前提是如果 timestamp 位於包含 base\_date 的季度中。

[**inquarter**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inquarter.htm) (date, basedate , shift [, first\_month\_of\_year = 1])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### inquartertodate

如果 timestamp 位於包含 base\_date 的季度部分內，且不超過 (可包含) base\_date 的最後一毫秒，則此函數會傳回 True。

[**inquartertodate**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inquartertodate.htm) (date, basedate , shift [, first\_month\_of\_year = 1])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### inmonth

此函數會傳回 True，前提是如果 timestamp 位於包含 base\_date 的月份中。

[**inmonth**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inmonth.htm)(date, basedate , shift)

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### inmonthtodate

如果 date 位於包含 basedate 的月份部分內，且不超過 (可包含) basedate 的最後一毫秒，則傳回 True。

[**inmonthtodate**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inmonthtodate.htm) (date, basedate , shift)

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### inmonths

此函數會發現時間戳記是否落在與基礎日期相同的月、雙月、季度、四月期或半年的期間內。還可以發現時間戳記是否在前一個或後一個時間期間內。

[**inmonths**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inmonths.htm)(n, date, basedate , shift [, first\_month\_of\_year = 1])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### inmonthstodate

此函數會發現時間戳記是否在月、雙月、季度、四月期或半年的期間內，且不超過 (可包含) `base_date` 的最後一毫秒。還可以發現時間戳記是否在前一個或後一個時間期間內。

[**inmonthstodate**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inmonthstodate.htm) (n, date, basedate , shift [, first\_month\_of\_year = 1])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### inweek

此函數會傳回 True，前提是如果 timestamp 位於包含 base\_date 的週中。

[**inweek**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inweek.htm)(date, basedate , shift [, weekstart])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### inweektodate

如果 timestamp 位於包含 base\_date 的週部分內，且不超過 (可包含) base\_date 的最後一毫秒，則此函數會傳回 True。

[**inweektodate**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inweektodate.htm) (date, basedate , shift [, weekstart])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### inlunarweek

此函數會判定 timestamp 是否位於包含 base\_date 的農曆週內。將 1 月 1 日視為該週的第一天，以定義 Qlik Sense 中的農曆週。除了該年的最後一週，每週都會確切包含七天。

[**inlunarweek**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inlunarweek.htm) (date, basedate , shift [, weekstart])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### inlunarweektodate

此函數會發現 timestamp 是否位於農曆週部分內，且不超過 (可包含) base\_date 的最後一毫秒。將 1 月 1 日視為該週的第一天，以定義 Qlik Sense 中的農曆週，而除了該年的最後一週，會確切包含七天。

[**inlunarweektodate**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inlunarweektodate.htm) (date, basedate , shift [, weekstart])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### inday

此函數會傳回 True，前提是如果 timestamp 位於包含 base\_timestamp 的日中。

[**inday**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inday.htm)(timestamp, basetimestamp , shift [, daystart])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### indaytotime

如果 timestamp 位於包含 base\_timestamp 的日部分內，且不超過 (可包含) base\_timestamp 的確切的毫秒，則此函數會傳回 True。

[**indaytotime**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/indaytotime.htm)(timestamp, basetimestamp , shift [, daystart])

### Start ... end 函數

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### yearstart

此函數傳回的時間戳記相當於包含 date 的年份的第一天開始。預設的輸出格式為指令碼中所設定的 DateFormat。

[**yearstart**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yearstart.htm)( date [, shift = 0 [, first\_month\_of\_year = 1]])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### yearend

此函數傳回的值相當於包含 date 的年份最後一天、最後一毫秒的時間戳記。預設的輸出格式為指令碼中所設定的 DateFormat。

[**yearend**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yearend.htm)( date [, shift = 0 [, first\_month\_of\_year = 1]])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### yearname

此函數傳回四位數的年度為顯示值，其基礎數值相當於包含 date 的年度的第一天、第一毫秒的時間戳記。

[**yearname**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yearname.htm)(date [, shift = 0 [, first\_month\_of\_year = 1]] )

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### quarterstart

此函數傳回的值相當於包含 date 的季度的第一毫秒的時間戳記。預設的輸出格式為指令碼中所設定的 DateFormat。

[**quarterstart**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quarterstart.htm)(date [, shift = 0 [, first\_month\_of\_year = 1]])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### quarterend

此函數傳回的值相當於包含 date 的季度的最後一毫秒的時間戳記。預設的輸出格式為指令碼中所設定的 DateFormat。

[**quarterend**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quarterend.htm)(date [, shift = 0 [, first\_month\_of\_year = 1]])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### quartername

此函數會傳回顯示當季度月份 (根據 MonthNames 指令碼變數進行格式設定) 和年度的顯示值，其基礎數值相當於該季度第一天、第一毫秒的時間戳記。

[**quartername**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quartername.htm)(date [, shift = 0 [, first\_month\_of\_year = 1]])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### monthstart

此函數傳回的值相當於包含 date 的月份第一天、第一毫秒的時間戳記。預設的輸出格式為指令碼中所設定的 DateFormat。

[**monthstart**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/monthstart.htm)(date [, shift = 0])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### monthend

此函數傳回的值相當於包含 `date` 的月份最後一天、最後一毫秒的時間戳記。預設的輸出格式為指令碼中所設定的 `DateFormat`。

[**monthend**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/monthend.htm)(date [, shift = 0])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### monthname

此函數會傳回顯示月份 (根據 MonthNames 指令碼變數進行格式設定) 和年度的顯示值，其基礎數值相當於該月份第一天、第一毫秒的時間戳記。

[**monthname**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/monthname.htm)(date [, shift = 0])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### monthsstart

此函數傳回的值相當於包含基本日期的月、雙月、季度、四月期或半年的第一毫秒的時間戳記。還可以尋找前一個或後一個時間期間的時間戳記。預設格式是指令碼中設定的 DateFormat。

[**monthsstart**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/monthsstart.htm)(n, date [, shift = 0 [, first\_month\_of\_year = 1]])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### monthsend

此函數傳回的值相當於包含基本日期的月、雙月、季度、四月期或半年的最後一毫秒的時間戳記。還可以尋找前一個或後一個時間期間的時間戳記。

[**monthsend**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/monthsend.htm)(n, date [, shift = 0 [, first\_month\_of\_year = 1]])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### monthsname

此函數會傳回一個顯示值，代表期間月份 (根據 MonthNames 指令碼變數進行格式設定) 和年度。基礎數值相當於包含基本日期的月、雙月、季度、四月期或半年的第一毫秒的時間戳記。

[**monthsname**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/monthsname.htm)(n, date [, shift = 0 [, first\_month\_of\_year = 1]])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### weekstart

此功能傳回的值相當於包含 date的行事曆週第一天、第一毫秒的時間戳記。預設的輸出格式為指令碼中所設定的 DateFormat。

[**weekstart**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/weekstart.htm)(date [, shift = 0 [,weekoffset = 0]])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### weekend

此功能傳回的值相當於包含 date 的該行事曆週最後一天的最後一毫秒的時間戳記。預設的輸出格式為指令碼中所設定的 DateFormat。

[**weekend**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/weekend.htm)(date [, shift = 0 [,weekoffset = 0]])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### weekname

此函數會傳回顯示年度和週數的值，其基礎數值相當於包含 date 之週的第一天、第一毫秒的時間戳記。

[**weekname**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/weekname.htm)(date [, shift = 0 [,weekoffset = 0]])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### lunarweekstart

此函數傳回的值相當於包含 date 的該農曆週第一天的第一毫秒的時間戳記。將 1 月 1 日視為該週的第一天，以定義 Qlik Sense 中的農曆週，而除了該年的最後一週，會確切包含七天。

[**lunarweekstart**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/lunarweekstart.htm)(date [, shift = 0 [,weekoffset = 0]])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### lunarweekend

此函數傳回的值相當於包含 date 的該農曆週最後一天的最後一毫秒的時間戳記。將 1 月 1 日視為該週的第一天，以定義 Qlik Sense 中的農曆週，而除了該年的最後一週，會確切包含七天。

[**lunarweekend**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/lunarweekend.htm)(date [, shift = 0 [,weekoffset = 0]])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### lunarweekname

此函數會傳回一個顯示值，顯示相當於包含 date 之農曆週第一天的第一毫秒的時間戳記的年和農曆週數。將 1 月 1 日視為該週的第一天，以定義 Qlik Sense 中的農曆週，而除了該年的最後一週，會確切包含七天。

[**lunarweekname**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/lunarweekname.htm)(date [, shift = 0 [,weekoffset = 0]])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### daystart

此函數傳回的值相當於包含在 time 引數中該日的第一毫秒的時間戳記。預設的輸出格式為指令碼中所設定的 TimestampFormat。

[**daystart**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/daystart.htm)(timestamp [, shift = 0 [, dayoffset = 0]])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### dayend

此函數傳回的值相當於包含在 time 中該日的最後一毫秒的時間戳記。預設的輸出格式為指令碼中所設定的 TimestampFormat。

[**dayend**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/dayend.htm)(timestamp [, shift = 0 [, dayoffset = 0]])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### dayname

此函數會傳回顯示日期的值，其基礎數值相當於包含 time 之日的第一毫秒的時間戳記。

[**dayname**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/dayname.htm)(timestamp [, shift = 0 [, dayoffset = 0]])

### Day numbering 函數

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### age

age 函數傳回生日為 date\_of\_birth 的某人於 timestamp 時的年齡 (以實歲計)。

[**age**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/age.htm)(timestamp, date\_of\_birth)

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### networkdays

networkdays 函數會傳回介於 start\_date 和 end\_date 之間 (可包含) 的工作日數 (星期一至星期五)，並考慮到所有選用的列出 holiday。

[**networkdays**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/networkdays.htm) (start:date, end\_date {, holiday})

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### firstworkdate

firstworkdate 函數會傳回在不晚於 end\_date 前結束，並考慮到所有選用的列出假日，而可達到 no\_of\_workdays (星期一至星期五) 的最近開始日期。end\_date 和 holiday 應該是有效的日期或時間戳記。

[**firstworkdate**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/firstworkdate.htm)(end\_date, no\_of\_workdays {, holiday} )

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### lastworkdate

lastworkdate 函數會傳回開始於 start\_date，並考慮到所有選用的列出 holiday，而可達到 no\_of\_workdays (星期一至星期五) 的最早結束日期。start\_date 和 holiday 應該是有效的日期或時間戳記。

[**lastworkdate**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/lastworkdate.htm)(start\_date, no\_of\_workdays {, holiday})

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### daynumberofyear

此函數會計算時間戳記在當年的第幾天。該計算從當年第一天的第一毫秒開始進行，但是第一個月可能發生位移。

[**daynumberofyear**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/daynumberofyear.htm)(date[,firstmonth])

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/date-time-functions.htm)

#### daynumberofquarter

此函數會計算時間戳記在當季度的第幾天。在建立主要行事曆時使用此函數。

[**daynumberofquarter**](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/daynumberofquarter.htm)(date[,firstmonth])