Spis treści

# Przekształcanie wartości określających datę

Przedstawione poniżej funkcje przekształcają wartości określające datę na liczby, umożliwiając wykonywanie obliczeń, oraz przekształcają liczby z powrotem na datę.

## Funkcja DateSerial

Zwraca wartość Date dla określonego roku, miesiąca i dnia.

## Funkcja DateValue

Zwraca obiekt Date z łańcucha reprezentującego datę.

Zwrócony obiekt jest wewnętrznie reprezentowany jako pojedyncza wartość liczbowa odpowiadająca określonej dacie. Tej wartości można użyć do obliczenia liczby dni między dwiema datami.

## Funkcja Day

Zwraca wartość określającą dzień miesiąca w oparciu o numer kolejny daty obliczony przez funkcję DateSerial lub DateValue.

## Funkcja Month

Zwraca wartość określającą miesiąc roku w oparciu o kolejny numer daty obliczony przez funkcję DateSerial lub DateValue.

## Funkcja WeekDay

Ta funkcja zwraca liczbę odpowiadającą dniu tygodnia reprezentowanemu przez kolejny numer daty, który jest generowany przez funkcje DateSerial lub DateValue.

## Funkcja Year

Zwraca wartość określającą rok roku w oparciu o numer kolejny daty obliczony przez funkcję DateSerial lub DateValue.

## Funkcja CDateToIso

Zwraca datę w formacie ISO bez separatorów (RRRRMMDD) z numeru seryjnego daty, który jest generowany przez funkcję DateSerial lub DateValue lub CDateFromIso.

Część roczna składa się z co najmniej czterech cyfr, z zerami na początku, jeśli wartość bezwzględna jest mniejsza niż 1000, może być ujemna z wiodącym znakiem minus, jeśli data przejścia oznacza rok przed wspólną erą (BCE) i może mieć więcej niż cztery cyfry, jeśli wartość bezwzględna jest większa niż 9999. Sformatowany ciąg zwracany może znajdować się w zakresie '-327680101' do '327671231'

Lata od 100 i powyżej 9999 są obsługiwane od LibreOffice 5.4.

## Funkcja CDateFromIso

Zwraca numer daty wewnętrznej z ciągu zawierającego datę w formacie ISO (RRRRMMDD lub RRRR-MM-DD).

Część roczna musi składać się z dwóch (obsługiwanych tylko w formacie YYMMDD bez separatorów w celu zapewnienia kompatybilności) lub przynajmniej czterech cyfr. W przypadku gdy cztery cyfry prowadzą do zera, jeśli bezwzględna wartość jest mniejsza niż 1000, może być ujemna z wiodącym znakiem minus, jeśli podana data oznacza rok przed wspólną erą (BCE) i może zawierać więcej niż cztery cyfry, jeśli wartość bezwzględna jest większa niż 9999. Sformatowany ciąg może zawierać się w zakresie '-327680101' do '327671231' lub '-32768-01-01' do '32767-12-31'.

Nieprawidłowa data powoduje błąd. Rok 0 nie jest akceptowany, ostatni dzień BCE to -0001-12-31, a następnego dnia CE to 0001-01-01. Daty przed 1582-10-15 są w kalendarzu gregoriańskim.

Podczas przekształcania numeru seryjnego daty w ciąg do wydruku, na przykład w przypadku polecenia Print lub MsgBox, używany jest domyślny kalendarz ustawień regionalnych, a w dniu 1582-10-15 data przełączenia może zostać przełączona na kalendarz juliański, co może skutkować wyświetleniem innej niż się spodziewano. Użyj Funkcji CDateToIso aby przekształcić taki numer daty na reprezentację ciągów w kalendarzu gregoriańskim.

Format YYYY-MM-DD z separatorami jest obsługiwany od LibreOffice 5.3.4. Lata mniej niż 100 lub więcej niż 9999 są akceptowane od LibreOffice 5.4, jeśli nie jest w trybie zgodności VBA.

## Funkcja CDateToUnoDate

Zwraca datę jako strukturę UNO com.sun.star.util.Date.

## Funkcja CDateFromUnoDate

Konwertuje strukturę UNO com.sun.star.util.Date na wartość daty.

## Funkcja CDateToUnoDate

Zwraca część czasową daty jako strukturę UNO com.sun.star.util.DateTime.

## Funkcja CDateFromUnoDateTime

Konwertuje strukturę UNO com.sun.star.util.DateTime na wartość daty.

## Funkcja DateAdd

Dodaje datę lub przedział czasu do podanej daty kilka razy i zwraca wynikową datę.

## Finkcja DateDiff

Zwraca liczbę przedziałów dat lub godzin między dwiema podanymi wartościami dat.

## Funkcja DatePart

Funkcja DatePart zwraca określoną część dnia.