Module
Contents
Index 🔎︎

# 轉換日期值

以下函式用於將日期值轉換為可計算的數字，或將數字轉換為日期值。

## DateSerial Function

傳回指定年、月或日的 Date 值。

## DateValue Function

從日期字串傳回日期值。此日期字串是單一數值形式的完整日期。您也可以使用此序號判斷兩個日期之差。

## Day Function

依函式 DateSerial 或 DateValue 產生的順序日期數，傳回表示某月中某一天的數值。

## Month Function

依 DateSerial 或 DateValue 函式產生的順序日期，傳回某年中的某月。

## WeekDay Function

傳回與由 DateSerial 或 DateValue 函式產生的工作日 (以順序日期數表示) 相對應的數字。

## Year Function

依 DateSerial 或 DateValue 函式產生的順序日期數傳回年份。

## CDateToIso Function

Returns the date in ISO format without separators (YYYYMMDD) from a serial date number that is generated by the DateSerial or the DateValue or the CDateFromIso function.

The year part consists of at least four digits, with leading zeros if the absolute value is less than 1000, it can be negative with a leading minus sign if the date passed denotes a year before the common era (BCE) and it can have more than four digits if the absolute value is greater than 9999. The formatted string returned can be in the range "-327680101" to "327671231".

Years less than 100 and greater than 9999 are supported since LibreOffice 5.4.

## CDateFromIso Function

Returns the internal date number from a string that contains a date in ISO format (YYYYMMDD or YYYY-MM-DD).

The year part must consist of either two (supported only in YYMMDD format without separators for compatibility) or at least four digits. With four digits leading zeros must be given if the absolute value is less than 1000, it can be negative with a leading minus sign if the date passed denotes a year before the common era (BCE) and it can have more than four digits if the absolute value is greater than 9999. The formatted string can be in the range "-327680101" to "327671231", or "-32768-01-01" to "32767-12-31".

An invalid date results in an error. Year 0 is not accepted, the last day BCE is -0001-12-31 and the next day CE is 0001-01-01. Dates before 1582-10-15 are in the proleptic Gregorian calendar.

When converting a date serial number to a printable string, for example for the Print or MsgBox command, the locale's default calendar is used and at that 1582-10-15 cutover date may switch to the Julian calendar, which can result in a different date being displayed than expected. Use the CDateToIso Function to convert such date number to a string representation in the proleptic Gregorian calendar.

The YYYY-MM-DD format with separators is supported since LibreOffice 5.3.4. Years less than 100 or greater than 9999 are accepted since LibreOffice 5.4 if not in VBA compatibility mode.

## CDateToUnoDate Function

Returns the date as a UNO com.sun.star.util.Date struct.

## CDateFromUnoDate Function

Converts a UNO com.sun.star.util.Date struct to a Date value.

## CDateToUnoDateTime Function

Returns the time part of the date as a UNO com.sun.star.util.DateTime struct.

## CDateFromUnoDateTime Function

Converts a UNO com.sun.star.util.DateTime struct to a Date value.

## DateAdd Function

在指定日期中多次增加日期間隔，並傳回結果日期。

## DateDiff Function

傳回兩個指定日期值之間的日期間隔數。

## DatePart Function

DatePart 函式會傳回日期的指定部分。