Модуль
Зміст
Покажчик 🔎︎

# Перетворення значень дати

Наступні функції використовуються для перетворення значень дати, числа і назад.

## Функція DateSerial

Повертає значення типу Date для зазначеного року, місяця або дня.

## Функція DateValue

Повертає значення дати по заданому рядку дати. Рядок дати є повною датою в єдиному числовому форматі. Цю дату в числовому форматі також можна використовувати для визначення різниці між двома датами.

## Функція Day

Повертає значення, що представляє день місяця на основі дати в числовому форматі, отриманої за допомогою функції DateSerial або DateValue.

## Функція Month

Повертає місяць року з дати у числовому форматі, отриманої за допомогою функції DateSerial або DateValue.

## Функція WeekDay

Повертає число, яке відповідає дню тижня, представленому датою в числовому форматі, створеної за допомогою функції DateSerial або DateValue.

## Функція Year

Повертає рік з дати у числовому форматі, створеної за допомогою функції DateSerial або DateValue.

## Функція CDateToIso

Повертає дату в форматі ISO без роздільників (РРРРММДД) з дати у числовому форматі, створеної за допомогою функції DateSerial, або DateValue, або CDateFromIso.

Рік зазначається принаймні 4-ма цифрами, з нулями на початку, якщо абсолютне значення менше ніж 1000; він може бути від'ємним з мінусом на початку, якщо дата належить до року до нашої ери, і може містити більше ніж 4 цифри, якщо абсолютне значення більше, ніж 9999. Повернутий відформатований рядок належить до діапазону від "-327680101" до "327671231".

Роки менші ніж 100 і більші ніж 9999 підтримуються, починаючи з LibreOffice 5.4.

## Функція CDateFromIso

Повертає внутрішній номер дати з рядка, який містить дату в форматі ISO (РРРРММДД або РРРР-ММ-ДД).

Рік зазначається принаймні 2-ма цифрами (підтримується для сумісності лише у форматі РРММДД без роздільників) або принаймні 4-ма цифрами. Для варіанту з 4-х цифр додаються на початку нулі, якщо абсолютне значення менше ніж 1000; рік може бути від'ємним з мінусом на початку, якщо дата належить до року до нашої ери, і може містити більше ніж 4 цифри, якщо абсолютне значення більше, ніж 9999. Повернутий відформатований рядок належить до діапазону від "-327680101" до "327671231" або від "-32768-01-01" до "32767-12-31".

Неправильна дата спричиняє помилку. Рік 0 не допускається, останнім днем до нашої ери є -0001-12-31 і наступним днем нашої ери є 0001-01-01. Дати перед 1582-10-15 задаються за пролептичним григоріанським календарем.

Під час конвертування числового подання дати в рядок для друку, наприклад, для команд Print або MsgBox, використовується типовий локальний календар і дати до 1582-10-15 можуть бути подані за Юліанським календарем, внаслідок чого може бути виведена не та дата, яка очікувалась. Для перетворення таких чисел на рядкове подання за пролептичним григоріанським календарем скористайтесь функцією CDateToIso.

Формат РРРР-ММ-ДД з роздільниками підтримується, починаючи з LibreOffice 5.3.4. Роки менші ніж 100 або більші ніж 9999 допускаються, починаючи з LibreOffice 5.4, якщо не увімкнено режим сумісності VBA.

## Функція CDateToUnoDate

Повертає дату як структуру UNO com.sun.star.util.Date.

## Функція CDateFromUnoDate

Перетворює структуру UNO com.sun.star.util.Date у значення дати.

## Функція CDateToUnoDateTime

Повертає часову частину дати як структуру часу UNO com.sun.star.util.Date

## Функція CDateFromUnoDateTime

Перетворює структуру UNO com.sun.star.util.DateTime у значення типу дата.

## Функція DateAdd

Додає інтервал дат до заданої дати кілька разів і повертає результуючу дату.

## Функція DateDiff

Повертає кількість інтервалів дат між двома заданими значеннями дат.

## Функція DatePart

Функція DatePart повертає вказану частину дати.