Język skryptowy systemu: Funkcje podstawowe

Nazwa

abs

Opis

abs zwraca wartość bezwzględną liczby.

Podpisy

Number abs(Number value)

Parametry

value jest liczbą.

Wynik

Wartość bezwzględna value jako liczby.

Źródła błędów

Brak

Przykłady

abs(3.14159) zwraca wartość 3.14159.

abs(-3.14159) zwraca -3.14159.

Kontekst

ALL

Uwagi

Zobacz także

Nazwa

ceil

Opis

ceil zaokrągla liczbę w górę.

Podpisy

Number ceil(Number value)

Number ceil(Number value, Number scale)

Parametry

value to liczba, która powinna zostać zaokrąglona w górę.

scale to liczba cyfr potomnych dla wyniku.

Wynik

Liczba value zaokrąglona do scale miejsc dziesiętnych. Jeśli wartość scale nie jest określona, przyjmowane jest 0 miejsc po przecinku. Jeśli scale jest liczbą ujemną lub nie jest liczbą całkowitą, jest zaokrąglana do round(abs(„scale”)).

Źródła błędów

Brak

Przykłady

ceil(3.14159) zwraca 4.

ceil(-3.1415) zwraca -3.

ceil(3.14159 2) zwraca 3.15.

ceil(-3.14159 4) zwraca -3.1415.

Kontekst

ALL

Uwagi

Zobacz także

ceil, round

Nazwa

floor

Opis

floor zaokrągla liczbę.

Podpisy

Number floor(Number value)

Number floor(Number value, Number scale)

Parametry

value to liczba, która powinna zostać zaokrąglona w dół.

scale to liczba cyfr potomnych dla wyniku.

Wynik

Liczba value jest zaokrąglana w dół do scale miejsc dziesiętnych. Jeśli wartość scale nie jest określona, przyjmowane jest 0 miejsc po przecinku. Jeśli scale jest liczbą ujemną lub nie jest liczbą całkowitą, jest zaokrąglana w dół do round(abs(„scale”)).

Źródła błędów

Brak

Przykłady

floor(3.14159) zwraca 3.

floor(-3.1415) zwraca -4.

floor(3.14159 4) zwraca wartość 3.1415.

floor(-3.14159 2) zwraca -3.15.

Kontekst

ALL

Uwagi

Zobacz także

ceil, round

Nazwa

max

Opis

max określa największą liczbę, CisDate lub Timestamp z maksymalnie 9 parametrów.

Podpisy

Number max(Number p1)

Number max(Number p1, Number p2)

Number max(Number p1, Number p2, Number p3,…, Number p9)

CisDate max(CisDate p1)

CisDate max(CisDate p1, CisDate p2)

CisDate max(CisDate p1, CisDate p2, CisDate p3,…, CisDate p9)

Timestamp max(Timestamp p1)

Timestamp max(Timestamp p1, Timestamp p2)

Timestamp max(Timestamp p1, Timestamp p2, Timestamp p3,…, Timestamp p9)

Parametry

p1 to pierwsza liczba, CisDate lub punkt w czasie.

p2 to druga liczba, CisDate lub punkt w czasie.

p3 to trzecia liczba, CisDate lub punkt w czasie.

[…]

p9 to dziewiąta liczba, CisDate lub punkt w czasie.

Wynik

Największa liczba, CisDate lub Timestamp spośród przesłanych parametrów.

Źródła błędów

Brak

Przykłady

max(-3, 1) zwraca 1.

max(MIN_DATE, MAX_DATE) zwraca 9999.12.31.

max(MIN_DATE, UNDEFINED_DATE) zwraca 1000.01.01.

Jeśli parameters odwołuje się do obiektu biznesowego z częścią updateInfo, wówczas max(parameters.object:updateInfo.createTime, parameters.object:updateInfo.updateTime) zwraca czas ostatniej zmiany. Jeśli obiekt biznesowy nie został zmieniony od czasu jego utworzenia, wyrażenie zwraca czas utworzenia.

Kontekst

ALL

Uwagi

Zobacz także

min

Nazwa

min

Opis

min określa najmniejszą liczbę, CisDate lub Timestamp z maksymalnie 9 parametrów.

Podpisy

Number min(Number p1)

Number min(Number p1, Number p2)

Number min(Number p1, Number p2, Number, p3,…, Number p9)

CisDate min(CisDate p1)

CisDate min(CisDate p1, CisDate p2)

CisDate min(CisDate p1, CisDate p2, CisDate p3,…, CisDate p9)

Timestamp min(Timestamp p1)

Timestamp min(Timestamp p1, Timestamp p2)

Timestamp min(Timestamp p1, Timestamp p2, Timestamp p3,…, Timestamp p9)

Parametry

p1 to pierwsza liczba, CisDate lub punkt w czasie.

p2 to druga liczba, CisDate lub punkt w czasie.

p3 to trzecia liczba, CisDate lub punkt w czasie.

[…]

p9 to dziewiąta liczba, CisDate lub punkt w czasie.

Wynik

Najmniejsza liczba, CisDate lub Timestamp spośród przesłanych parametrów.

Źródła błędów

Brak

Przykłady

min(-3, 1) zwraca -3.

min(MIN_DATE, MIN_DATE) zwraca 1000.01.01.

min(MIN_DATE, UNDEFINED_DATE) zwraca 1000.01.01.

Kontekst

ALL

Uwagi

Zobacz także

max

Nazwa

neg

Opis

neg zwraca ujemną wartość liczby.

Podpisy

Number neg(Number value)

Parametry

value jest liczbą.

Wynik

Ujemna wartość value jako liczba.

Źródła błędów

Brak

Przykłady

neg(3.14159) zwraca -3.14159.

neg(-3.14159) zwraca 3.14159.

Kontekst

ALL

Uwagi

Zobacz także

abs

Nazwa

round

Opis

round zaokrągla liczbę.

Podpisy

Number round(Number value)

Number round(Number value, Number scale)

Parametry

value to liczba, która ma zostać zaokrąglona.

scale to liczba cyfr potomnych dla wyniku.

Wynik

Liczba value zaokrąglona do scale miejsc dziesiętnych. Jeśli wartość scale nie zostanie określona, przyjmowane jest 0 miejsc po przecinku. Jeśli scale jest liczbą ujemną lub nie jest liczbą całkowitą, używane jest round(abs(„scale”)).

Źródła błędów

Brak

Przykłady

round(3.14159) zwraca 3.

round(-3.1415) zwraca -3.

round(3.14159 4) zwraca 3.1416.

round(-3.14159 4) zwraca -3.1416.

Kontekst

ALL

Uwagi

Zobacz także

ceil, floor

Nazwa

not

Opis

not odwraca wartość prawdy (Boolean).

Podpisy

Boolean not(Boolean value)

Parametry

value jest liczbą.

Wynik

Jeśli value ma wartość true, zwracana jest wartość false. Jeśli value nie jest wartością true, zwracana jest wartość true.

Źródła błędów

Brak

Przykłady

not(true) zwraca wartość prawdy false.

not(false) zwraca wartość prawdy true.

not(isEmpty(intersection(list(format(today(), „EEE”, „en”)), list(„Sat”, „Sun”)))) zwraca true, jeśli dzisiaj jest sobota lub niedziela, w przeciwnym razie false.

Kontekst

ALL

Uwagi

Zobacz także

Nazwa

char

Opis

char zwraca znak Unicode numerycznego punktu kodowego.

Podpisy

String char(Number codepoint)

Parametry

codepoint to punkt kodowy znaku Unicode.

Wynik

Znak Unicode punktu kodowego jako ciąg jednego znaku.

Źródła błędów

Brak

Przykłady

char(97) zwraca znak Unicode a.

Kontekst

ALL

Uwagi

Comarch ERP Enterprise wykorzystuje Unicode w całym systemie. Oznacza to, że wszystkie popularne znaki globalne mogą być używane i drukowane na formularzach.

Zobacz także

charAt

Nazwa

charAt

Opis

charAt zwraca numeryczny punkt kodowy znaku Unicode.

Podpisy

Number charAt(String text, Number index)

Parametry

text to ciąg znaków zawierający znaki Unicode.

index to pozycja znaku Unicode w ciągu znaków.

Wynik

Punkt kodowy znaku Unicode na pozycji określonej przez index w łańcuchu znaków text.

Źródła błędów

Jeśli index nie jest prawidłową pozycją ciągu text, zwracana jest wartość zero.

Przykłady

charAt(„abc”, 1) zwraca wartość 98 dla znaku Unicode b.

Kontekst

ALL

Uwagi

Comarch ERP Enterprise wykorzystuje Unicode w całym systemie. Oznacza to, że wszystkie popularne znaki globalne mogą być używane i drukowane na formularzach.

Zobacz także

char

Nazwa

decrypt

Opis

decrypt używa klucza, aby zwrócić zaszyfrowany tekst w postaci niezaszyfrowanej.

Podpisy

String decrypt(String key, String encryptedText)

Parametry

key to 32-cyfrowy klucz, za pomocą którego tekst został zaszyfrowany.

encryptedText to zaszyfrowany tekst.

Wynik

Tekst encryptedText jako niezaszyfrowany ciąg znaków.

Źródła błędów

Jeśli klucz key nie ma długości 32 znaków, zwracana jest wartość zero.

Przykłady

decrypt(„u22Teu88mN/8hND92ch+hkDj84PlQMMWUE2Y4cnVuCk=”) odszyfrowuje zaszyfrowany tekst przy użyciu klucza standardowego i zwraca niezaszyfrowaną wartość jako ciąg znaków.

Kontekst

ALL

Uwagi

Zobacz także

encrypt

Nazwa

encrypt

Opis

encrypt szyfruje tekst przy użyciu klucza i zwraca zaszyfrowany tekst jako ciąg znaków.

Podpisy

String encrypt(String plainText)

String encrypt(String key, String plainText)

Parametry

plainText to ciąg znaków, który ma zostać zaszyfrowany.

key jest kluczem. Jeśli nie określono klucza, plainText jest szyfrowany przy użyciu standardowego klucza.

Wynik

Tekst plainText jako zaszyfrowany ciąg znaków.

Źródła błędów

Jeśli klucz key nie jest znany systemowi, zwracana jest wartość zero.

Przykłady

encrypt(„abc”) szyfruje tekst abc przy użyciu standardowego klucza systemowego i zwraca zaszyfrowaną wartość jako ciąg znaków.

Kontekst

ALL

Uwagi

Zobacz także

decrypt

Nazwa

endsWith

Opis

endsWith sprawdza, czy ciąg znaków kończy się określonym sufiksem.

Podpisy

Boolean endsWith(String text, String suffix)

Parametry

text to ciąg znaków, który ma zostać sprawdzony.

suffix jest znakiem lub ciągiem znaków.

Wynik

Jeśli ciąg text kończy się na suffix, wynikiem jest true, w przeciwnym razie false.

Źródła błędów

Brak

Przykłady

endsWith(„ERP”, „P”) zwraca wartość true.

endsWith(„ERP”, „E”) zwraca wartość false.

endsWith(„Comarch”, „arch”) zwraca wartość true.

endsWith(„Enterprise”, „”) zwraca wartość true.

endsWith(„”, „CEE”) zwraca wartość false.

endsWith(„”,””) zwraca wartość true.

Kontekst

ALL

Uwagi

Zobacz także

startsWith

Nazwa

format

Opis

format zwraca parametr jako sformatowany ciąg znaków. Parametr jest formatowany w różny sposób w zależności od typu danych.

Podpisy

String format(CisDate date)

String format(CisDate date, String pattern)

String format(CisDate date, String pattern, String language)

String format(Timestamp time)

String format(Timestamp time, String pattern)

String format(Timestamp time, String pattern, String language)

String format(Number number)

String format(Number number, String pattern)

String format(Number number, String pattern, String language)

String format(String text)

String format(String text, String p1)

String format(String text, String p1, String p2)

String format(String text, String p1, String p2, String p3,…,String p8)

String format(String text, String[] parameters)

Parametry

date jest CisDate.

time to punkt w czasie (znacznik czasu).

number jest liczbą.

pattern to ciąg znaków z instrukcjami formatowania CisDate, godziny lub liczby. Jeśli format nie zostanie określony, wyprowadzana jest liczba w formacie # oraz CisDate lub godzina w formacie rrrrMMddHHmmssSSS.

language to 2-literowy kod ISO służący do formatowania CisDate, godziny lub liczby zgodnie ze standardowym formatem krajowym.

text to ciąg znaków, który może zawierać symbole zastępcze {0}, {1}, {2},…, {n}.

p1 do p8 to ciągi do 8 znaków z określonymi wartościami dla symboli zastępczych w text.

parameters to lista z dowolną liczbą symboli zastępczych.

Wynik

Jeśli parametr jest ciągiem znaków, format zastępuje symbole zastępcze w ciągu znaków. Dla wszystkich innych typów danych, format zwraca parametr jako sformatowany ciąg znaków.

Źródła błędów

Jeśli nie istnieje odpowiedni format dla określonego języka, wynikiem jest zero.

Przykłady

Dla ciągów znaków:

format(„Hello {0}!”, „world”) zwraca Hello world!.

format(„Hello {0}!”, list(„world”)) zwraca Hello world!.

Dla CisDate:

format(MIN_DATE, „dd MMMM rrrr”, „pl”)) zwraca 01 styczeń 0002.

format(MIN_DATE)) zwraca 00020101000002.

Dla punktów czasowych:

Dla liczb:

format(3,1415926)) zwraca 3.

format(3,1415926, „###.##”, „de”)) zwraca 3,14.

format(3,1415926, „0000.0000”, „de”)) zwraca 0003,1416.

format(3,1415926, „#.00”, „en”)) zwraca 3.14.

format(3,1415926, „#%”)) zwraca 314%.

Kontekst

ALL

Uwagi

Jeśli w tekście ma zostać zastąpionych więcej niż 8 symboli zastępczych, wartości muszą zostać przesłane jako lista ciągów znaków.

Zobacz także

dateString, timeString, toHtml

Symbol

Wyjaśnienie

0

Liczba z zerem wiodącym

#

Liczba bez zera wiodącego

.

Separator dziesiętny w zależności od języka

–

Znak minus

,

Grupowanie znaków w zależności od języka

;

Oddziela formaty dodatnie i ujemne.

%

Mnoży liczbę przez 100 i wyświetla ją jako wartość procentową.

’

Charakteryzuje znaki specjalne.

G

Era, np. GG->AD

y

Rok, np. rrrr->2021, rrrr->21

M

Miesiąc, np. MM->08, MMM->sierpień, MMMM->sierpień, w zależności od języka.

w

tydzień w roku, np. ww->27

W

tydzień na miesiąc, np. W->2

D

dzień roku, np: DDD->183

d

Dzień miesiąca, np. dd->05, d->5

F

dzień tygodnia w miesiącu, np. F->2

E

Dzień tygodnia, np. EEE->Tue, EEEE-> Tuesday, w zależności od języka.

a

am/pm, np. aa -> PM

H

godzin dziennie (0-23), np. 13

k

Godzina na dzień (1-24), np. 24

K

Godzina w am/ppm (0-11), np. 0

h

Godzina w am/pm (1-12), np. 12

m

minut na godzinę, np. 53

s

Sekunda w minucie, np. 55

S

Milisekunda w sekundzie, np. 978

Nazwa

lastIndexOf

Opis

indexOf określa ostatnią pozycję znaku lub ciągu znaków w tekście.

Podpisy

Number lastIndexOf(String text, String searchValue)

Number lastIndexOf(String text, String searchValue, Number firstPos)

Parametry

text to tekst do przeszukania.

searchValue to znak lub ciąg znaków, który ma zostać wyszukany.

firstPos to pozycja w tekście, od której powinno rozpocząć się wyszukiwanie.

Wynik

Pozycja pierwszego wystąpienia searchValue w text od pozycji firstPos. W przeciwieństwie do funkcji indexOf, text jest przeszukiwany wstecz od firstPos.

Jeśli wyszukiwanie nie powiodło się, zwracane jest -1.

Źródła błędów

Brak

Przykłady

lastIndexOf(„abcabc”, „a”) zwraca 3.

lastIndexOf(„abcabc”, „b”) zwraca 4.

lastIndexOf(„abcabc”, „d”) zwraca -1.

lastIndexOf(„abcabc”, „bc”) zwraca 4.

lastIndexOf(„abcabc”, „”) zwraca 5.

lastIndexOf(„”, „a”) zwraca -1.

lastIndexOf(„”, „”) zwraca 0.

lastIindexOf(„abcabc” „a”, 2) zwraca 0.

lastIndexOf(„abcabc”, „a”, 3) zwraca 3.

lastIndexOf(„abcabc”, „a”, -10) zwraca -1.

lastIndexOf(„abcabc”, „a”, 10) zwraca 3.

substring(objectName(event.guid), lastIndexOf(objectName(event.guid), „.”)) zwraca nazwę jednostki biznesowej zdarzenia typu Jednostka biznesowa bez jej przestrzeni nazw.

Kontekst

ALL

Uwagi

Zobacz także

indexOf, substring

Nazwa

lenght

Opis

length zwraca długość ciągu znaków.

Podpisy

Number (String text)

Parametry

text to ciąg znaków, którego długość ma zostać określona.

Wynik

Długość ciągu znaków text.

Źródła błędów

Brak

Przykłady

length(„abc”) zwraca 3.

length(„”) zwraca 0.

Kontekst

ALL

Uwagi

Długość to liczba znaków w ciągu znaków. Pierwszy znak ma pozycję 0. Dlatego ostatni znak niepustego ciągu text ma pozycję length(text)-1.

Liczba elementów na liście jest określana przez size.

Zobacz także

Nazwa

startsWith

Opis

startsWith sprawdza, czy ciąg znaków zaczyna się od określonego prefiksu.

Podpisy

Boolean startsWith(String text, String prefix)

Parametry

text to ciąg znaków, który ma zostać sprawdzony.

prefix to znak lub ciąg znaków.

Wynik

Jeśli ciąg text zaczyna się od prefix, wynikiem jest true, w przeciwnym razie false.

Źródła błędów

Brak

Przykłady

startsWith(„ERP”, „E”) zwraca wartość true.

startsWith(„ERP”, „e”) zwraca wartość false.

startsWith(„Comarch”, „Com”) zwraca wartość true.

startsWith(„Enterprise”, „”) zwraca wartość true.

startsWith(„”, „CEE”) zwraca wartość false.

startsWith(„”,””) zwraca wartość true.

Kontekst

ALL

Uwagi

Zobacz także

endsWith

Nazwa

substring

Opis

substring zwraca wszystkie znaki ciągu znaków od określonej pozycji.

Podpisy

String substring(String text, firstIncluded)

String substring(String text, firstIncluded, firstExcluded)

Parametry

text to ciąg znaków.

firstIncluded to pozycja pierwszego znaku w parametrze text, który ma zostać zwrócony.

firstExcluded to pozycja pierwszego znaku po firstIncluded, który nie powinien zostać zwrócony.

Wynik

Ciąg znaków zawierający wszystkie znaki w text od pozycji firstIncluded (włącznie) do pozycji firstExcluded (wyłącznie).

Źródła błędów

Jeśli wartość firstIncluded jest ujemna lub większa niż firstExcluded, zwracana jest wartość zero.

Przykłady

substring(„012345”, 2) zwraca 2345.

substring(„012345”, 2, 4) zwraca 23.

substring(„012345”, 2, 2) zwraca „”.

Kontekst

ALL

Uwagi

Zobacz także

indexOf, lastIndexOf

Nazwa

toHtml

Opis

toHtml zwraca ciąg znaków ze znakami specjalnymi jako encje HTML.

Podpisy

String toHtml(String plainText)

Parametry

plainText to ciąg znaków.

Wynik

Źródła błędów

Brak

Przykłady

toHtml(„<p>text</p>”) zwraca ciąg znaków &lt;p&gt;text&lt;/p&gt;.

toHtml(„Pozdrowienia”) zwraca ciąg znaków Gr&uuml;&szlig;e.

Poniższy przykład dodaje link do artykułu 10010 do opisu działania:

formatDescriptionHTML(„company”, „<a href=\”” + getURL(getCustomizingValue(„com.cisag.app.General”)->Company) + „\”>” + toHtml(getCustomizingValue(„com.cisag.app.General”)->Company:searchString) + „</a>”) zastępuje parametr company w nazwie działania wyszukiwanym terminem partnera powiązanego z klientem i linkiem do otwarcia partnera.

Kontekst

ALL

Uwagi

Zobacz także

format

Nazwa

toLower

Opis

toLower konwertuje wszystkie wielkie litery w ciągu znaków na małe litery.

Podpisy

String (String text)

Parametry

text to ciąg znaków, którego wielkie litery mają zostać zamienione na małe.

Wynik

Ciąg znaków text ze wszystkimi dużymi literami zamienionymi na małe.

Źródła błędów

Brak

Przykłady

toLower(„Abc123”) zwraca abc123.

toLower(„ABC123”) zwraca abc123.

toLower(„”) zwraca „”.

Kontekst

ALL

Uwagi

Zobacz także

toUpper

Nazwa

toUpper

Opis

toUpper konwertuje wszystkie małe litery w ciągu znaków na wielkie litery.

Podpisy

String (String text)

Parametry

text to ciąg znaków, którego małe litery mają zostać zamienione na duże.

Wynik

Ciąg znaków text ze wszystkimi małymi literami zamienionymi na wielkie.

Źródła błędów

Brak

Przykłady

toUpper(„Abc123”) zwraca ABC123.

toUpper(„abc123”) zwraca ABC123.

toUpper(„”) zwraca „”.

Kontekst

ALL

Uwagi

Zobacz także

toLower

Nazwa

trim

Opis

trim usuwa spacje na początku i końcu ciągu znaków.

Podpisy

String (String text)

Parametry

string to ciąg znaków.

Wynik

Usunięto ciąg znaków text ze spacjami na początku i końcu.

Źródła błędów

Brak

Przykłady

trim(” JOB „) zwraca wartość JOB.

Kontekst

ALL

Uwagi

Spacje w ciągu znaków text nie są usuwane.

Zobacz także

Nazwa

unzipText

Opis

unzipText rozpakowuje ciąg znaków z BLOB i zwraca go jako ciąg znaków.

Podpisy

String unzipText(Bytes blob)

Parametry

blob to ciąg znaków przechowywany jako BLOB.

Wynik

Rozpakowany ciąg znaków.

Źródła błędów

Jeśli BLOB nie zawiera żadnego spakowanego tekstu, wynikiem funkcji jest zero.

Przykłady

Jeśli parameters.object jest modułem tekstowym, wówczas unzipText(parameters.object:text) zwraca zawartość modułu tekstowego jako ciąg znaków.

Kontekst

ALL

Uwagi

W celu rozpakowania za pomocą funkcji unzipText, BLOB musi być spakowany zgodnie ze standardową procedurą. Nie dotyczy to wszystkich obiektów BLOB.

Zobacz także

Nazwa

addDays

Opis

addDays dodaje dni do CisDate lub punktu w czasie.

Podpisy

CisDate addDays(CisDate date, Number offset)

Timestamp addDays(Timestamp time, Number offset)

Parametry

date jest CisDate.

time to punkt w czasie.

offset to liczba dni dodawana do parametru date lub time.

Wynik

CisDate lub Timestamp offset dni po parametrze date lub time.

Źródła błędów

Brak

Przykłady

addDays(today(), 7) zwraca CisDate za dokładnie jeden tydzień.

addDays(now(), 7) zwraca czas za dokładnie jeden tydzień.

addDays(startOfDay(now()), 1) zwraca czas jutro o godzinie 00:00:00.000.

Kontekst

ALL

Uwagi

Jeśli offset jest ujemny, wówczas addDays zwraca CisDate lub czas, który leży przed date lub time.

Zobacz także

addHours, addMilliseconds, addMinutes, addSeconds

Nazwa

addHours

Opis

addHours dodaje godziny do CisDate lub godziny.

Podpisy

CisDate addHours(CisDate date, Number offset)

Timestamp addHours(Timestamp time, Number offset)

Parametry

date jest CisDate.

time to punkt w czasie.

offset to liczba godzin dodawana do parametru date lub time.

Wynik

CisDate lub Timestamp offset godzin po parametrze date lub time.

Źródła błędów

Brak

Przykłady

addHours(today(), 24) zwraca CisDate dokładnie za jeden dzień.

addHours(now(), 24) zwraca czas za dokładnie jeden dzień.

Kontekst

ALL

Uwagi

Jeśli offset jest ujemny, wówczas addHours zwraca CisDate lub czas, który jest przed date lub time.

Zobacz także

addDays, addMilliseconds, addMinutes, addSeconds

Nazwa

addMilliseconds

Opis

addMilliseconds dodaje milisekundy do CisDate lub punktu w czasie.

Podpisy

CisDate addMilliseconds(CisDate date, Number offset)

Timestamp addMilliseconds(Timestamp time, Number offset)

Parametry

date jest CisDate.

time to punkt w czasie.

offset to liczba milisekund dodawana do parametru date lub time.

Wynik

CisDate lub Timestamp offset milisekund po parametrze date lub time.

Źródła błędów

Brak

Przykłady

addMilliseconds(today(), 24*60*60*1000) zwraca CisDate dokładnie za jeden dzień.

addMilliseconds(now(),24*60*60*1000) zwraca czas za dokładnie jeden dzień.

addMilliseconds(endOfDay(now()), 1) zwraca jutrzejszą godzinę dokładnie jedną milisekundę po północy.

Kontekst

ALL

Uwagi

Jeśli offset jest ujemny, wówczas addMilliseconds zwraca CisDate lub czas, który leży przed date lub time.

Zobacz także

addDays, addHours, addMinutes, addSeconds

Nazwa

addMinutes

Opis

addMinutes dodaje minuty do CisDate lub godziny.

Podpisy

CisDate addMinutes(CisDate date, Number offset)

Timestamp addMinutes(Timestamp time, Number offset)

Parametry

date jest CisDate.

time to punkt w czasie.

offset to liczba minut, która ma zostać dodana do parametru date lub time.

Wynik

CisDate lub Timestamp offset minut po parametrze date lub time.

Źródła błędów

Brak

Przykłady

addMinutes(today(), 24*60) zwraca CisDate za dokładnie jeden dzień.

addMinutes(now(),24*60) zwraca czas za dokładnie jeden dzień.

Kontekst

ALL

Uwagi

Jeśli offset jest ujemny, wówczas addMinutes zwraca CisDate lub czas, który leży przed date lub time.

Zobacz także

addDays, addHours, addMilliseconds, addSeconds

Nazwa

addSeconds

Opis

addSeconds dodaje sekundy do CisDate lub godziny.

Podpisy

CisDate addSeconds(CisDate date, Number offset)

Timestamp addSeconds(Timestamp time, Number offset)

Parametry

date jest CisDate.

time to punkt w czasie.

offset to liczba sekund dodawana do parametru date lub time.

Wynik

CisDate lub Timestamp offset sekund po parametrze date lub time.

Źródła błędów

Brak

Przykłady

addSeconds(today(), 24*60*60) zwraca CisDate dokładnie za jeden dzień.

addSeconds(now(),24*60*60) zwraca czas za dokładnie jeden dzień.

Kontekst

ALL

Uwagi

Jeśli offset jest ujemny, wówczas addSeconds zwraca CisDate lub czas, który leży przed date lub time.

Zobacz także

addDays, addHours, addMilliseconds, addMinutes

Nazwa

createCisDate

Opis

createCisDate tworzy dowolną datę CisDate.

Podpisy

CisDate createCisDate(Number year)

CisDate createCisDate(Number year, Number month)

CisDate createCisDate(Number year, Number month, Number day)

CisDate createCisDate(Number year, Number month, Number day, Number hour)

CisDate createCisDate(Number year, Number month, Number day, Number hour, Number minute)

CisDate createCisDate(Number year, Number month, Number day, Number hour, Number minute, Number second)

CisDate createCisDate(Number year, Number month, Number day, Number hour, Number minute, Number second, Number millisecond)

CisDate createCisDate(String timeZoneId, Number year)

CisDate createCisDate(String timeZoneId, Number year, Number month)

CisDate createCisDate(String timeZoneId, Number year, Number month, Number day)

CisDate createCisDate(String timeZoneId, Number year, Number month, Number day, Number hour)

CisDate createCisDate(String timeZoneId, Number year, Number month, Number day, Number hour, Number minute)

CisDate createCisDate(String timeZoneId, Number year, Number month, Number day, Number hour, Number minute, Number second)

CisDate createCisDate(String timeZoneId, Number year, Number month, Number day, Number hour, Number minute, Number second, Number millisecond)

Parametry

year oznacza rok.

month oznacza miesiąc.

day to dzień.

hour oznacza godzinę.

minute oznacza minutę.

second to sekunda

millisecond oznacza milisekundę.

timeZoneId to strefa czasowa CisDate.

Wszystkie parametry z wyjątkiem year są opcjonalne. Brakujące cząstki czasu są wypełniane wartością 0. Brakujące cząstki daty są wypełniane wartością 1. Jeśli nie określono strefy czasowej, jest ona pobierana z bieżącego kontekstu uruchomieniowego.

Wynik

A CisDate.

Źródła błędów

Brak

Przykłady

createCisDate(year(today()), 1, 1) zwraca CisDate na początku bieżącego roku.

createCisDate(year(today()), 3, -4) zwraca CisDate 5 dni przed rozpoczęciem 3 miesiąca w bieżącym roku.

createCisDate(„GMT”, 1980) zwraca CisDate 1980-01-01 GMT.

createCisDate(„GMT”, 1980, 0, 0) zwraca CisDate 1979-11-30 GMT.

Kontekst

ALL

Uwagi

Dostępne identyfikatory stref czasowych można wyświetlić w kolumnie Identyfikacja w aplikacji Strefy czasowe.

Zobacz także

createTimestamp

Nazwa

createTimestamp

Opis

createTimestamp tworzy dowolny czas.

Podpisy

Timestamp createTimestamp(Number year)

Timestamp createTimestamp(Number year, Number month)

Timestamp createTimestamp(Number year, Number month, Number day)

Timestamp createTimestamp(Number year, Number month, Number day, Number hour)

Timestamp createTimestamp(Number year, Number month, Number day, Number hour, Number minute)

Timestamp createTimestamp(Number year, Number month, Number day, Number hour, Number minute, Number second)

Timestamp createTimestamp(Number year, Number month, Number day, Number hour, Number minute, Number second, Number millisecond)

Timestamp createTimestamp(String timeZoneId, Number year)

Timestamp createTimestamp(String timeZoneId, Number year, Number month)

Timestamp createTimestamp(String timeZoneId, Number year, Number month, Number day)

Timestamp createTimestamp(String timeZoneId, Number year, Number month, Number day, Number hour)

Timestamp createTimestamp(String timeZoneId, Number year, Number month, Number day, Number hour, Number minute)

Timestamp createTimestamp(String timeZoneId, Number year, Number month, Number day, Number hour, Number minute, Number second)

Timestamp createTimestamp(String timeZoneId, Number year, Number month, Number day, Number hour, Number minute, Number second, Number millisecond)

Parametry

year oznacza rok.

month oznacza miesiąc.

day to dzień.

hour oznacza godzinę.

minute oznacza minutę.

second oznacza sekundę

millisecond oznacza milisekundę.

timeZoneId to strefa czasowa, w której wyświetlane są cząsteczki czasu.

Wszystkie parametry z wyjątkiem year są opcjonalne. Brakujące cząstki czasu są wypełniane wartością 0. Brakujące cząstki daty są wypełniane wartością 1

Wynik

Znacznik czasu w strefie czasowej systemu.

Źródła błędów

Brak

Przykłady

createTimestamp(year(today()), 1, 1) zwraca czas na początku bieżącego roku.

createTimestamp(year(today()), 3, -4) zwraca czas 5 dni przed rozpoczęciem 3 miesiąca w bieżącym roku.

createTimestamp(„EST”, year(today()), 1, 1) zwraca czas na początku roku w określonej strefie czasowej. W zależności od strefy czasowej kontekstu uruchomieniowego i bieżącej daty, może to być na przykład 2019-12-31 14:00:00.000 w strefie czasowej CES.

createTimestamp(1980) zwraca 1980-01-01 00:00:00.000 w strefie czasowej bieżącego kontekstu uruchomieniowego.

Kontekst

ALL

Uwagi

Zobacz także

createCisDate

Nazwa

day

Opis

day zwraca dzień miesiąca jako liczbę dla CisDate lub punktu w czasie.

Podpisy

Number day(CisDate date)

Number day(Timestamp time)

Parametry

date jest CisDate, którego dzień miesiąca jest określony.

time to punkt w czasie, którego dzień miesiąca jest określony.

Wynik

Dzień miesiąca jako liczba.

Źródła błędów

Brak

Przykłady

day(createCisDate(1980, 1, 1) zwraca 1.

day(today()) zwraca dzisiejszy dzień miesiąca.

Kontekst

ALL

Uwagi

Poszczególne części CisDate są dostępne ze strefą czasową wskazaną w CisDate. Na przykład day(createCisDate(„EET”, 1980, 1, 1) zwraca liczbę 1 niezależnie od strefy czasowej bieżącego kontekstu uruchomieniowego.

Jeśli wygenerowana data CisDate zostanie przekonwertowana na punkt w czasie i zostanie określony jej rok, wynik zależy od strefy czasowej bieżącego kontekstu uruchomieniowego. Na przykład, day(toTimestamp(createCisDate(„EET”, 1980, 1, 1)) zwraca liczbę 31, jeśli bieżący kontekst runtime używa strefy czasowej, która jest na zachód od EET.

Zobacz także

hour, millisecond, minute, month, second, year

Nazwa

days

Opis

days określa długość okresu między dwoma CisDates lub punktami w czasie w dniach.

Podpisy

Number days(CisDate from, CisDate to)

Number days(Timestamp from, Timestamp to)

Parametry

from to pierwsza CisDate lub punkt w czasie.

to jest drugą datą CisDate lub punktem w czasie.

Wynik

Funkcja zwraca długość okresu między from i to w dniach. Miejsca dziesiętne są obcinane w wyniku funkcji, tj. 1,9 dnia staje się 1 dniem. W przeciwieństwie do funkcji określających długość okresu w jednostkach czasu: godzina, minuta, sekunda i milisekunda, days zwraca wartość różną od 0, gdy tylko from i to przypadają na różne dni, nawet jeśli między nimi nie ma 24 godzin. Na przykład, days(addSeconds(today(), -1), today()) zwraca 1, a hours(addSeconds(today(), -1), today()) zwraca 0. Takie zachowanie wynika ze zmiennej długości miesięcy i przepisów dotyczących czasu letniego, roku przestępnego i sekundy przestępnej.

Źródła błędów

Brak

Przykłady

days(today(), addDays(today(), 7)) zwraca 7.

days(today(), addHours(today(), 20)) zwraca 0.

days(today(), addHours(today(), 36) zwraca 1.

days(addHours(today(), 36), today()) zwraca -1.

days(addHours(today(), -4), today()) zwraca 1.

days(now(), addDays(now(), 7)) zwraca 7.

days(createCisDate(year(today())), createCisDate(year(today()))) + 1)) > 365 jest prawdą, jeśli bieżący rok jest rokiem przestępnym.

Kontekst

ALL

Uwagi

Jeśli from i to są typu danych CisDate, są one konwertowane do strefy czasowej GMT+0 do obliczeń. days(createCisDate(„NST”, 1980), createCisDate(„NPT1”, 1980)) zwraca zatem -1, ponieważ strefa czasowa NST znajduje się na zachód, a strefa czasowa NPT1 na wschód od GMT+0. CisDate from przypada zatem na ostatni dzień 1979 roku ze strefy czasowej GMT+0.

Zobacz także

hours, milliseconds, minutes, months, seconds, weeks, years

Nazwa

dateString

Opis

dateString zwraca część daty CisDate lub punkt w czasie jako ciąg znaków.

Podpisy

String dateString(CisDate date)

String dateString(Timestamp time)

Parametry

date to połączenie godziny i strefy czasowej.

time to punkt w czasie z dokładnością do milisekund.

Wynik

Część daty date lub time. Jeśli parametrem jest czas, część daty jest zwracana w strefie czasowej bieżącego kontekstu uruchomieniowego.

Źródła błędów

Brak

Przykłady

dateString(today()) i dateString(now()) zwracają część dzisiejszej daty jako ciąg znaków.

dateString(MIN_DATE) zwraca 1000-01-01 jako ciąg znaków zgodnie z formatowaniem w ustawieniach użytkownika.

dateString(MAX_DATE) zwraca 9999-12-31 jako ciąg znaków zgodnie z formatowaniem w ustawieniach użytkownika.

dateString(createCisDate(„NPT1”, 1980)) zwraca 1980-01-01.

dateString(createTimestamp(„NPT1”, 1980)) zwraca 1979-12-31, jeśli strefa czasowa bieżącego kontekstu uruchomieniowego jest na zachód od Katmandu.

Kontekst

ALL

Uwagi

Zobacz także

format, timeString, timeZoneString

Nazwa

endOfDay

Opis

endOfDay określa ostatni czas na koniec dnia.

Podpisy

Timestamp endOfDay(CisDate date)

Timestamp endOfDay(Timestamp time)

Parametry

date to CisDate, którego ostatni czas jest określany na koniec dnia.

time to czas, którego ostatni czas jest określany na koniec dnia.

Wynik

Ostatni moment pod koniec dnia

Źródła błędów

Brak

Przykłady

endOfDay(today()) i endOfDay(now()) zwracają godzinę 23:59:59.999 dnia dzisiejszego.

setActivityWorkDelay(seconds(activity:creationTime, endOfDay(today()))) + 1) ustawia czas rozpoczęcia działania na pierwszą sekundę po północy następnego dnia.

Kontekst

ALL

Uwagi

Zobacz także

startOfDay

Nazwa

hour

Opis

hour zwraca godzinę w ciągu dnia jako liczbę dla CisDate lub punktu w czasie.

Podpisy

Number hour(CisDate date)

Number hour(Timestamp time)

Parametry

date to CisDate, którego godzina jest określona.

time to punkt w czasie, którego godzina jest określona.

Wynik

Godzina w ciągu dnia jako liczba.

Źródła błędów

Brak

Przykłady

hour(createCisDate(1980, 1, 1) zwraca 0.

hour(createCisDate(1980, 1, 1, 7) zwraca 7.

hour(now()) zwraca bieżącą godzinę dnia.

Kontekst

ALL

Uwagi

Poszczególne części CisDate są dostępne przy użyciu strefy czasowej określonej w CisDate. Na przykład hour(createCisDate(„EET”, 1980, 1, 1, 7) zwraca liczbę 7, niezależnie od strefy czasowej bieżącego kontekstu uruchomieniowego.

Jeśli wygenerowana data CisDate zostanie przekonwertowana na czas i zostanie określona jej godzina, wynik zależy od strefy czasowej bieżącego kontekstu uruchomieniowego. Na przykład hour(toTimestamp(createCisDate(„EET”, 1980, 1, 1)) zwraca liczbę 23, jeśli istnieje różnica jednej godziny między EET a strefą czasową bieżącego kontekstu uruchomieniowego.

Zobacz także

day, millisecond, minute, month, second, year

Nazwa

hours

Opis

hours określa długość okresu między dwoma CisDates lub punktami w czasie w godzinach.

Podpisy

Number hours(CisDate from, CisDate to)

Number hours(Timestamp from, Timestamp to)

Parametry

from jest pierwszą datą CisDate lub punktem w czasie.

to jest drugą datą CisDate lub punktem w czasie.

Wynik

Funkcja zwraca długość okresu między from i to w godzinach. Miejsca dziesiętne są obcinane w wyniku funkcji, tj. 1,9 godziny staje się 1 godziną.

Źródła błędów

Brak

Przykłady

hours(today(), addHours(today(), 7)) zwraca 7.

hours(today(), addMinutes(today(), 20)) zwraca 0.

hours(today(), addMinutes(today(), 80) zwraca 1.

hours(addMinutes(today(), 80), today()) zwraca -1.

hours(addMinutes(today(), -4), today()) zwraca 0.

hours(now(), addHours(now(), 7)) zwraca 7.

Kontekst

ALL

Uwagi

Jeśli from i to są typu danych CisDate, są one konwertowane do strefy czasowej GMT+0 do obliczeń. hours(createCisDate(„NPT1”, 1980), createCisDate(„NST”, 1980)) zwraca zatem 9, ponieważ istnieje różnica czasu wynosząca 9 godzin między strefami czasowymi NPT1 i NST.

Zobacz także

days, milliseconds, minutes, months, seconds, weeks, years

Nazwa

isMaxDate

Opis

isMaxDate sprawdza, czy CisDate lub czas ma największą wyświetlaną wartość.

Podpisy

Boolean isMaxDate(CisDate date)

Boolean isMaxDate(Timestamp time)

Parametry

date jest CisDate.

time to punkt w czasie.

Wynik

Jeśli date lub time ma największą wyświetlaną wartość, wynikiem funkcji jest true.

Źródła błędów

Brak

Przykłady

isMaxDate(MAX_DATE) zwraca wartość true.

isMaxDate(MIN_DATE) zwraca wartość false.

Kontekst

ALL

Uwagi

Największa wyświetlana wartość CisDate lub czasu (znacznika czasu) może być używana na przykład dla zakresów ważności, które są otwarte u góry.

Zobacz także

isMinDate, isUndefinedDate

Nazwa

isMinDate

Opis

isMinDate sprawdza, czy CisDate lub czas ma najmniejszą reprezentowalną wartość.

Podpisy

Boolean isMinDate(CisDate date)

Boolean isMinDate(Timestamp time)

Parametry

date jest CisDate.

time to punkt w czasie.

Wynik

Jeśli date lub time ma najmniejszą reprezentowalną wartość, wynikiem funkcji jest true.

Źródła błędów

Brak

Przykłady

isMinDate(MIN_DATE) zwraca wartość true.

isMinDate(MAX_DATE) zwraca wartość false.

Kontekst

ALL

Uwagi

Najmniejsza wyświetlana wartość CisDate lub czasu (znacznik czasu) może być używana na przykład dla zakresów ważności, które są otwarte na dole.

Zobacz także

isMaxDate, isUndefinedDate

Nazwa

isUndefinedDate

Opis

isUndefinedDate sprawdza, czy CisDate lub czas ma wartość, której nie można wyświetlić.

Podpisy

Boolean isUndefinedDate(CisDate date)

Boolean isUndefinedDate(Timestamp time)

Parametry

date jest CisDate.

time to punkt w czasie.

Wynik

Jeśli date lub time nie ma reprezentowalnej wartości, wynikiem funkcji jest true.

Źródła błędów

Brak

Przykłady

isUndefinedDate(UNEDFINED_DATE) zwraca wartość true.

isMinDate(MAX_DATE) zwraca wartość false.

isMinDate(MIN_DATE) zwraca wartość true.

Kontekst

ALL

Uwagi

Niezdefiniowana wartość jest używana dla CisDates i czasów przed przypisaniem konkretnej wartości, takiej jak czas ostatniej zmiany obiektu biznesowego (w atrybucie updateInfo.updateTime), który nie został zmieniony od czasu jego utworzenia.

Zobacz także

isMaxDate, isMinDate

Nazwa

milisecond

Opis

millisecond zwraca milisekundę jako liczbę dla CisDate lub punktu w czasie.

Podpisy

Number millisecond(CisDate date)

Number millisecond(Timestamp time)

Parametry

date jest CisDate, którego milisekunda jest określona.

time to punkt w czasie, którego milisekunda jest określona.

Wynik

Milisekunda jako liczba.

Źródła błędów

Brak

Przykłady

millisecond(createCisDate(1980, 1, 1) zwraca 0.

millisecond(createCisDate(1980, 12, 31, 23, 59, 59, 999) zwraca 999.

second(now()) zwraca bieżącą milisekundę.

Kontekst

ALL

Uwagi

Poszczególne części CisDate są dostępne w strefie czasowej określonej w CisDate.

Zobacz także

day, hour, minute, month, second, year

Nazwa

milliseconds

Opis

milliseconds określa długość okresu między dwoma CisDates lub punktami w czasie w milisekundach.

Podpisy

Number milliseconds(CisDate od, CisDate do)

Number milliseconds(Timestamp from, Timestamp to)

Parametry

from jest pierwszą datą CisDate lub punktem w czasie.

to jest drugą datą CisDate lub punktem w czasie.

Wynik

Funkcja zwraca długość okresu między from i to w milisekundach.

Źródła błędów

Brak

Przykłady

milliseconds(today(), addMilliseconds(today(), 7)) zwraca 7.

milliseconds(today(), addSeconds(today(), 7)) zwraca 7000.

milliseconds(addMilliseconds(today(), -1), today()) zwraca 1.

milliseconds(now(), addMilliseconds(now(), 7)) zwraca 7.

Kontekst

ALL

Uwagi

Jeśli from i to są typu danych CisDate, są one konwertowane do strefy czasowej GMT+0 na potrzeby obliczeń.

Zobacz także

days, hours, minutes, months, seconds, weeks, years

Nazwa

minute

Opis

minute zwraca minutę jako liczbę dla CisDate lub punktu w czasie.

Podpisy

Number minute(CisDate date)

Number minute(Timestamp time)

Parametry

date to CisDate, którego minuta jest określona.

time to punkt w czasie, którego minuta jest określona.

Wynik

Minuta w godzinie jako liczba.

Źródła błędów

Brak

Przykłady

minute(createCisDate(1980, 1, 1) zwraca 0.

minute(createCisDate(1980, 1, 1, 0, 5) zwraca 5.

minute(now()) zwraca bieżącą minutę w godzinie.

Kontekst

ALL

Uwagi

Poszczególne części CisDate są dostępne ze strefą czasową wskazaną w CisDate. Na przykład, minute(createCisDate(„EET”, 1980, 1, 1, 0, 5) zwraca liczbę 5 niezależnie od strefy czasowej bieżącego kontekstu uruchomieniowego.

Jeśli wygenerowana data CisDate zostanie przekonwertowana na czas i zostanie określona jej godzina, wynik zależy od strefy czasowej bieżącego kontekstu uruchomieniowego. Na przykład, minute(toTimestamp(createCisDate(„NPT1”, 1980, 1, 1, 12)) zwraca liczbę 15, ponieważ strefa czasowa bieżącego kontekstu uruchomieniowego („CET”) jest 4 godziny i 45 minut po strefie czasowej Katmandu.

Zobacz także

day, hour, millisecond, month, second, year

Nazwa

minutes

Opis

minutes określa długość okresu między dwoma CisDates lub punktami w czasie w minutach.

Podpisy

Number minutes(CisDate from, CisDate to)

Number minutes(Timestamp from, Timestamp to)

Parametry

from jest pierwszą datą CisDate lub punktem w czasie.

to jest drugą datą CisDate lub punktem w czasie.

Wynik

Funkcja zwraca długość okresu między from i to w minutach. Miejsca dziesiętne są obcinane w wyniku funkcji, tj. 1,9 minuty staje się 1 minutą.

Źródła błędów

Brak

Przykłady

minutes(today(), addMinutes(today(), 7)) zwraca 7.

minutes(today(), addSeconds(today(), 20)) zwraca 0.

minutes(today(), addSeconds(today(), 80) zwraca 1.

minutes(addSeconds(today(), 80), today()) zwraca -1.

minutes(addSeconds(today(), -1), today()) zwraca 0.

minutes(now(), addMinutes(now(), 7)) zwraca 7.

Kontekst

ALL

Uwagi

Jeśli from i to są typu danych CisDate, są one konwertowane do strefy czasowej GMT+0 do obliczeń. minutes(createCisDate(„NPT1”, 1980), createCisDate(„NST”, 1980)) zwraca zatem 555, ponieważ istnieje różnica czasu 555 minut między strefami czasowymi NPT1 i NST.

Zobacz także

days, hours, milliseconds, months, seconds, weeks, years

Nazwa

month

Opis

month zwraca miesiąc w roku jako liczbę dla CisDate lub punktu w czasie.

Podpisy

Number month(CisDate date)

Number month(Timestamp time)

Parametry

date to CisDate, którego miesiąc jest określony w roku.

time to punkt w czasie, którego miesiąc w roku jest określony.

Wynik

Miesiąc w roku jako liczba.

Źródła błędów

Brak

Przykłady

month(createCisDate(1980, 1, 10) zwraca 1.

month(today()) zwraca dzisiejszy miesiąc w roku.

Kontekst

ALL

Uwagi

Poszczególne części CisDate są dostępne ze strefą czasową wskazaną w CisDate. Na przykład, month(createCisDate(„EET”, 1980, 1, 10) zwraca liczbę 1, niezależnie od strefy czasowej bieżącego kontekstu uruchomieniowego.

Jeśli wygenerowana data CisDate zostanie przekonwertowana na punkt w czasie i zostanie określony jej rok, wynik zależy od strefy czasowej bieżącego kontekstu uruchomieniowego. Na przykład, month(toTimestamp(createCisDate(„EET”, 1980, 1, 1)) zwraca liczbę 12, jeśli bieżący kontekst runtime używa strefy czasowej, która jest na zachód od EET.

Zobacz także

day, hour, millisecond, minute, second, year

Nazwa

months

Opis

months określa długość okresu między dwiema datami CisDate lub punktami w czasie w miesiącach.

Podpisy

Number months(CisDate od, CisDate do)

Number months(Timestamp from, Timestamp to)

Parametry

from to pierwsza CisDate lub punkt w czasie.

to jest drugą datą CisDate lub punktem w czasie.

Wynik

Funkcja zwraca długość okresu między from i to w miesiącach. Miejsca dziesiętne są obcinane w wyniku funkcji, tj. 1,9 miesiąca staje się 1 miesiącem. W przeciwieństwie do funkcji określających długość okresu czasu w jednostkach czasu godzina, minuta, sekunda i milisekunda, months zwraca wartość różną od 0, gdy tylko from i to przypadają na różne miesiące. Na przykład, months(addSeconds(createTimestamp(1980), -1), createTimestamp(1980)) zwraca 1, a hours(addSeconds(createTimestamp(1980), -1), createTimestamp(1980)) zwraca 0. Takie zachowanie wynika ze zmiennej długości miesięcy i przepisów dotyczących czasu letniego, roku przestępnego i sekundy przestępnej.

Źródła błędów

Brak

Przykłady

months(today(), addDays(today(), 20)) zwraca 0, jeśli do następnej zmiany miesiąca pozostało więcej niż 20 dni.

months(addDays(today(), -20), today()) zwraca 0, jeśli od początku miesiąca nie minęło jeszcze 20 dni.

Kontekst

ALL

Uwagi

Jeśli from i to są typu danych CisDate, są one konwertowane do strefy czasowej GMT+0 do obliczeń. months(createCisDate(„NST”, 1980), createCisDate(„NPT1”, 1980)) zwraca zatem -1, ponieważ strefa czasowa NST znajduje się na zachód, a strefa czasowa NPT1 na wschód od GMT+0. Oznacza to, że CisDate from przypada na ostatni dzień 1979 roku, patrząc ze strefy czasowej GMT+0.

Zobacz także

days, hours, milliseconds, minutes, seconds, weeks, years

Nazwa

now

Opis

now zwraca bieżący czas.

Podpisy

Timestamp now()

Parametry

Brak

Wynik

Bieżący czas, tj. bieżąca data z dokładnością do milisekund.

Źródła błędów

Brak

Przykłady

now() zwraca aktualny czas systemu.

Kontekst

ALL

Uwagi

Zobacz także

today

Nazwa

second

Opis

second zwraca sekundę jako liczbę dla CisDate lub punktu w czasie.

Podpisy

Number second(CisDate date)

Number second(Timestamp time)

Parametry

date to CisDate, którego druga wartość jest określona.

time to punkt w czasie, którego druga część jest określona.

Wynik

Sekunda w minucie jako liczba.

Źródła błędów

Brak

Przykłady

second(createCisDate(1980, 1, 1) zwraca 0.

second(createCisDate(1980, 1, 1, 0, 0, 5) zwraca 5.

second(now()) zwraca bieżącą sekundę w minucie.

Kontekst

ALL

Uwagi

Poszczególne części CisDate są dostępne w strefie czasowej określonej w CisDate.

Zobacz także

day, hour, millisecond, minute, month, year

Nazwa

seconds

Opis

seconds określa długość okresu między dwoma CisDates lub punktami w czasie w sekundach.

Podpisy

Number seconds(CisDate from, CisDate to)

Number seconds(Timestamp from, Timestamp to)

Parametry

from to pierwsza CisDate lub punkt w czasie.

to jest drugą datą CisDate lub punktem w czasie.

Wynik

Funkcja zwraca długość okresu między from i to w sekundach. Miejsca dziesiętne są obcinane w wyniku funkcji, tj. 1,9 sekundy staje się 1 sekundą.

Źródła błędów

Brak

Przykłady

seconds(today(), addSeconds(today(), 7)) zwraca 7.

seconds(today(), addMilliseconds(today(), 800)) zwraca 0.

seconds(today(), addMilliseconds(today(), 1000) zwraca 1.

seconds(addMilliseconds(today(), -1000), today()) zwraca -1.

seconds(addMilliseconds(today(), -1), today()) zwraca 0.

seconds(now(), addSeconds(now(), 7)) zwraca 7.

Kontekst

ALL

Uwagi

Jeśli from i to są typu danych CisDate, są one konwertowane do strefy czasowej GMT+0 na potrzeby obliczeń.

Zobacz także

days, hours, milliseconds, minutes, months, weeks, years

Nazwa

startOfDay

Opis

startOfDay określa pierwszy raz na początku dnia.

Podpisy

Timestamp startOfDay(CisDate date)

Timestamp startOfDay(Timestamp time)

Parametry

date to CisDate, której pierwsza godzina jest określana na początku dnia.

time to czas, którego pierwsza godzina jest określana na początku dnia.

Wynik

Pierwszy raz na początku dnia

Źródła błędów

Przykłady

startOfDay(today()) i startOfDay(now()) zwracają czas o godzinie 00:00:00.000 dnia dzisiejszego.

setActivityWorkDelay(seconds(activity:creationTime, endOfDay(today()))) ustawia czas rozpoczęcia działania na ostatnią sekundę przed północą bieżącego dnia.

Kontekst

ALL

Uwagi

Zobacz także

endOfDay

Nazwa

timeString

Opis

timeString zwraca część czasową CisDate lub punkt w czasie jako ciąg znaków.

Podpisy

String timeString(CisDate date)

String timeString(Timestamp time)

Parametry

date to CisDate, czyli połączenie punktu w czasie ze strefą czasową.

time to punkt w czasie z dokładnością do milisekund.

Wynik

Część czasowa date lub time.

Źródła błędów

Brak

Przykłady

timeString(today()) zwraca część czasu na początku dnia dzisiejszego jako ciąg znaków.

timeString(now()) zwraca część czasu bieżącego punktu w czasie jako ciąg znaków.

timeString(createCisDate(„NPT1”, 1980)) zwraca 00:00.

timeString(createTimestamp(„NPT1”, 1980)) zwraca 21:15:00, jeśli różnica między strefą czasową bieżącego kontekstu uruchomieniowego a strefą czasową Katmandu wynosi 2:45 godziny.

Kontekst

ALL

Uwagi

Zobacz także

dateString, format, timeZoneId, timeZoneString

Nazwa

timeZoneId

Opis

timeZoneId zwraca identyfikator strefy czasowej CisDate lub punktu w czasie.

Podpisy

String timeZoneId(CisDate date)

String timeZoneId(Timestamp time)

Parametry

date to CisDate, którego strefa czasowa jest określona.

Wynik

Identyfikacja strefy czasowej date.

Źródła błędów

Brak

Przykłady

timeZoneId(today()) zwraca identyfikator strefy czasowej bieżącego kontekstu uruchomieniowego.

timeZoneId(createCisDate(„NPT1”, 1980)) zwraca NPT1.

timeZoneId(createTimestamp(„NPT1”, 1980)) zwraca identyfikator strefy czasowej bieżącego kontekstu uruchomieniowego.

Kontekst

ALL

Uwagi

Dostępne identyfikatory stref czasowych można wyświetlić w kolumnie Identyfikacja w aplikacji Strefy czasowe.

Zobacz także

dateString, timeString, timeZoneString

Nazwa

timeZoneString

Opis

timeZoneString zwraca skrót strefy czasowej CisDate lub punktu w czasie.

Podpisy

String timeZoneString(CisDate date)

String timeZoneString(Timestamp time)

Parametry

date to CisDate, którego strefa czasowa jest określona.

time to punkt w czasie, którego strefa czasowa jest określona.

Wynik

Skrót strefy czasowej od date lub time.

Źródła błędów

Brak

Przykłady

timeZoneString(today()) zwraca skrót strefy czasowej bieżącego kontekstu uruchomieniowego.

timeZoneString(createCisDate(„NPT1”, 1980)) zwraca NPT.

timeZoneString(createTimestamp(„NPT1”, 1980)) zwraca skrót strefy czasowej bieżącego kontekstu uruchomieniowego.

Kontekst

ALL

Uwagi

Dostępne identyfikatory stref czasowych można wyświetlić w kolumnie Identyfikacja w aplikacji Strefy czasowe.

Zobacz także

dateString, timeString, timeZoneId

Nazwa

today

Opis

today zwraca bieżącą datę jako CisDate bez składnika czasu.

Podpisy

Timestamp today()

Timestamp (String timeZoneId)

Parametry

timeZoneId jest identyfikatorem strefy czasowej.

Wynik

Funkcja zwraca bieżącą datę systemu jako CisDate, tj. dokładny czas milisekundowy ze strefą czasową.

Jeśli określono identyfikację strefy czasowej, data jest generowana i wyprowadzana zgodnie z określoną strefą czasową. Jeśli nie podano identyfikacji strefy czasowej, strefa czasowa jest pobierana z bieżącego kontekstu wykonawczego.

Źródła błędów

Brak

Przykłady

today() zwraca bieżącą datę systemu.

Kontekst

ALL

Uwagi

Dostępne identyfikatory stref czasowych można wyświetlić w kolumnie Identyfikacja w aplikacji Strefy czasowe.

Zobacz także

now

Nazwa

toTimestamp

Opis

toTimestamp konwertuje CisDate na czas.

Podpisy

Timestamp toTimestamp(CisDate date)

Parametry

date to CisDate, która ma zostać przekonwertowana na czas.

Wynik

Parametr date jako godzina

Źródła błędów

Brak

Przykłady

toTimestamp(today) zwraca pierwszą godzinę bieżącego dnia.

Kontekst

ALL

Uwagi

Zobacz także

cast, createTimestamp

Nazwa

weeks

Opis

weeks określa długość okresu między dwiema datami CisDate lub punktami w czasie w tygodniach kalendarzowych.

Podpisy

Number weeks(CisDate od, CisDate do)

Number weeks(Timestamp from, Timestamp to)

Parametry

from to pierwsza CisDate lub punkt w czasie.

to jest drugą datą CisDate lub punktem w czasie.

Wynik

Funkcja zwraca długość okresu między from i to w tygodniach kalendarzowych. Miejsca dziesiętne są obcinane w wyniku funkcji, tj. 1,9 tygodnia staje się 1 tygodniem. W przeciwieństwie do funkcji określających długość okresu w jednostkach czasu: godzina, minuta, sekunda i milisekunda, weeks zwraca wartość inną niż 0, gdy tylko from i to przypadają na różne tygodnie. Na przykład funkcja weeks(addDays(createCisDate(2020), -1), createCisDate(2020)) zwraca 0, ponieważ 31 grudnia 2019 r. i 1 stycznia 2020 r. należą do tygodnia kalendarzowego 1 w 2020 r. Z drugiej strony funkcja weeks(addDays(createCisDate(2018), -1), createCisDate(2020)) zwraca 1, ponieważ 31 grudnia 2017 r. należy do tygodnia kalendarzowego 52 w 2017 r., a 1 stycznia 2018 r. należy do tygodnia kalendarzowego 1 w 2018 r.

Źródła błędów

Brak

Przykłady

weeks(createCisDate(year(today()))), today()) + 1 zwraca bieżący tydzień kalendarzowy.

weeks(today(), addDays(today(), 2)) zwraca 0, jeśli bieżący tydzień kalendarzowy nadal ma co najmniej 2 dni.

Kontekst

ALL

Uwagi

Jeśli from i to są typu danych CisDate, są one konwertowane do strefy czasowej GMT+0 na potrzeby obliczeń.

Zobacz także

days, hours, milliseconds, minutes, months, seconds, years

Nazwa

year

Opis

year zwraca rok CisDate lub punkt w czasie jako liczbę.

Podpisy

Number year(CisDate date)

Number year(Timestamp time)

Parametry

date to CisDate, którego rok jest określony.

time to punkt w czasie, którego rok jest określony.

Wynik

Rok jako liczba.

Źródła błędów

Brak

Przykłady

year(createCisDate(1980, 1, 1) zwraca 1980.

year(today()) zwraca bieżący rok.

Kontekst

ALL

Uwagi

Poszczególne części CisDate są dostępne ze strefą czasową wskazaną w CisDate. Na przykład year(createCisDate(„EET”, 1980, 1, 1) zwraca liczbę 1980, niezależnie od strefy czasowej bieżącego kontekstu uruchomieniowego.

Jeśli wygenerowana data CisDate zostanie przekonwertowana na punkt w czasie i zostanie określony jej rok, wynik zależy od strefy czasowej bieżącego kontekstu uruchomieniowego. Na przykład, year(toTimestamp(createCisDate(„EET”, 1980, 1, 1)) zwraca liczbę 1979, jeśli bieżący kontekst runtime używa strefy czasowej, która jest na zachód od EET.

Zobacz także

day, hour, millisecond, minute, month, second

Nazwa

years

Opis

years określa długość okresu między dwoma CisDates lub punktami w czasie w latach.

Podpisy

Number years(CisDate od, CisDate do)

Number years(Timestamp from, Timestamp to)

Parametry

from jest pierwszą datą CisDate lub punktem w czasie.

to jest drugą datą CisDate lub punktem w czasie.

Wynik

Funkcja zwraca długość okresu między from i to w latach. Miejsca dziesiętne są obcinane w wyniku funkcji, tj. 1,9 roku staje się 1 rokiem. W przeciwieństwie do funkcji określających długość okresu w jednostkach czasu: godzina, minuta, sekunda i milisekunda, funkcja years zwraca wartość inną niż 0, gdy tylko from i to przypadają na różne lata. Tak więc, years(addSeconds(createTimestamp(1980), -1), createTimestamp(1980)) zwraca 1, a hours(addSeconds(createTimestamp(1980), -1), createTimestamp(1980)) zwraca 0. Takie zachowanie wynika ze zmiennej długości miesięcy i przepisów dotyczących czasu letniego, roku przestępnego i sekundy przestępnej.

Źródła błędów

Brak

Przykłady

years(today(), addDays(today(), 100)) zwraca 0, jeśli do następnego przełomu roku pozostało więcej niż sto dni.

years(addDays(today(), -100), today()) zwraca 0, jeśli od początku roku nie minęło jeszcze sto dni.

Kontekst

ALL

Uwagi

Jeśli from i to są typu danych CisDate, są one konwertowane do strefy czasowej GMT+0 do obliczeń. years(createCisDate(„NST”, 1980), createCisDate(„NPT1”, 1980)) zwraca zatem -1, ponieważ strefa czasowa NST znajduje się na zachód, a strefa czasowa NPT1 na wschód od GMT+0. CisDate from przypada zatem na ostatni dzień 1979 roku, patrząc ze strefy czasowej GMT+0.

Zobacz także

days, hours, milliseconds, minutes, months, seconds, weeks

Nazwa

add

Opis

add dodaje kolejny element do listy.

Podpisy

add(Unknown[] list, Unknown element)

Parametry

list jest listą.

element to element, który ma zostać dodany do listy list.

Wynik

Element element jest dodawany do listy list jako ostatni element. Typ danych elementu element zostaje zachowany.

Źródła błędów

Element element może zostać dodany do listy list tylko wtedy, gdy typ danych elementu jest zgodny z typem danych elementu listy lub może zostać do niego przekonwertowany. Na przykład, jeśli lista list1 ma typ danych Number[], wówczas wyrażenie add(list1, „1”) prowadzi do błędu składniowego, ponieważ ciąg znaków nie może zostać przekonwertowany na liczbę. Jeśli natomiast list1 jest zadeklarowana jako String[], wówczas wyrażenie add(list1, 1) jest poprawne składniowo, ponieważ liczba może zostać przekonwertowana na ciąg znaków.

Przykłady

add(list1, 3) dodaje element 3 do listy list1.

add(list1, now()) dodaje bieżący czas do listy list1 jako nowy element.

Kontekst

ALL

Uwagi

Zobacz także

addAll, list, union

Nazwa

addAll

Opis

addAll dodaje wszystkie elementy innej listy do listy.

Podpisy

addAll(Unknown[] list, Unknown[] listToAdd)

Parametry

list to lista, do której mają zostać dodane elementy innej listy.

listToAdd jest listą, której elementy mają zostać dodane do listy list.

Wynik

Lista list jest rozszerzana o wszystkie elementy listy listToAdd. Typy danych elementów na liście listToAdd zostają zachowane.

Źródła błędów

Element listy listToAdd może zostać dodany tylko wtedy, gdy typ danych elementu jest zgodny z typem danych elementu listy list lub może zostać do niego przekonwertowany. Na przykład, jeśli list ma typ danych Number[], a element listy listToAdd ma typ danych elementu String, wówczas element list nie może zostać dodany, ponieważ ciąg znaków nie może zostać przekonwertowany na liczbę. Jeśli jednak list ma typ danych String[], a element listy listToAdd ma typ danych Number, wówczas element list może zostać dodany, ponieważ liczba może zostać przekonwertowana na ciąg znaków.

Przykłady

addAll(list1, list2) dodaje wszystkie elementy listy list2 do listy list1. Typy danych elementów są zachowywane.

addAll(list1, list(now())) dodaje bieżący czas do listy list1 jako nowy element typu danych elementu Timestamp.

addAll(list1, minus(list2, list1)) dodaje do listy list1 wszystkie elementy listy list2, które nie znajdują się jeszcze na liście list1.

Kontekst

ALL

Uwagi

Funkcja union(list1, list2) zwraca połączenie list list1 i list2. Należy użyć funkcji union, aby wykluczyć zduplikowane wartości.

Zobacz także

add, list, union

Nazwa

contains

Opis

contains sprawdza, czy lista zawiera określony element.

Podpisy

Boolean contains(Unknown[] list, Unknown element)

Parametry

list jest listą.

element jest elementem.

Wynik

Jeśli lista list zawiera element element, zwracana jest wartość prawdy true, w przeciwnym razie false.

Źródła błędów

Brak.

Przykłady

contains(list(1, 2, 3), 1) zwraca wartość true.

contains(list(1, 2, 3), 4) zwraca false.

contains(list(1, 2, 3), „1”) zwraca false.

Kontekst

ALL

Uwagi

Zobacz także

intersection

Nazwa

intersection

Nazwa

isEmpty

Opis

isEmpty określa, czy lista jest pusta.

Podpisy

Boolean isEmpty(unknown[] list)

Parametry

list to lista, która ma zostać sprawdzona.

Wynik

Funkcja zwraca wartość true, jeśli list jest pusta. Jeśli list zawiera co najmniej jeden element, zwracana jest wartość false.

Źródła błędów

Brak

Przykłady

isEmpty(list()) zwraca wartość true.

isEmpty(list(3)) zwraca wartość false.

isEmpty(new(String[3])) zwraca wartość false.

Kontekst

ALL

Uwagi

Zobacz także

size

Nazwa

list

Opis

list tworzy nową listę z określonymi elementami.

Podpisy

List list(Unknown e1, Unknown e2,…,Unknown eN)

Parametry

e1, e2,…, eN to elementy listy, która ma zostać wygenerowana. Wszystkie parametry są opcjonalne.

Wynik

Funkcja list tworzy nową, wypełnioną listę z elementami e1, e2,…, eN. Typ danych pierwszego elementu e1 określa typ danych listy. Jeśli nie podano żadnego parametru, funkcja zwraca pustą listę typu danych Unknown[].

Jeśli użytkownik użyje list do przypisania wartości do istniejącej listy, typ danych listy jest już ustalony i nie można go zmienić. W takim przypadku można przypisać tylko elementy, których typy danych elementów można przekonwertować na typ danych listy. Elementy przyjmują wówczas typ danych elementu listy.

Jeśli użytkownik chce utworzyć listę z elementami o różnych typach danych elementów (np. jako listę parametrów dla aplikacji działającej w tle), musi wybrać pierwszy element, aby pozostałe elementy mogły zostać przekonwertowane na jego typ danych elementu. Na przykład liczby mogą być konwertowane na ciągi znaków, ale nie odwrotnie. Jeśli nie jest to możliwe, można zadeklarować listę jako Unknown[] i przypisać do niej elementy za pomocą funkcji add.

Źródła błędów

Jeśli elementy e2, e3,…, eN nie mają tego samego typu danych elementu co e1 i nie mogą zostać przekonwertowane na typ danych elementu e1, wówczas funkcja powoduje błąd składni.

Przykłady

list() zwraca pustą listę danych typu Unknown[].

list(1, 2, 3) zwraca listę typu danych Number[] z 3 elementami typu danych Number.

list(„now”, now()) zwraca listę danych typu String[] z 2 elementami typu String lub Timestamp.

list(1, 2, „three”) i list(1, 2, list(3)) powodują błąd składni, ponieważ typ danych String lub Number[] nie może zostać przekonwertowany na typ danych Number.

list(null, now(), 1, „two”, 3) tworzy listę typu danych Unknown[] z 5 elementami o różnych typach danych elementów. Typ danych elementu pierwszego elementu null to Unknown.

Kontekst

ALL

Uwagi

Podczas korzystania z elementów listy, najpierw przyjmują one typ danych listy. Jeśli lista zawiera elementy o różnych typach danych, może być konieczne rzutowanie elementów za pomocą funkcji cast przed ich użyciem.

Zobacz także

add, addAll

Nazwa

minus

Opis

minus zwraca różnicę między dwiema lub więcej listami.

Podpisy

Unknown[] minus(Unknown[] list1, Unknown[] list2)

Unknown[] minus(Unknown[] list1, Unknown[] list2,…,Unknown[] listN)

Parametry

list1 to pierwsza lista.

list2 to druga lista.

listN jest ostatnią listą.

Wynik

Zbiór różnic przeniesionych list jako lista o tym samym typie danych co list1. Zbiór różnic składa się ze wszystkich elementów listy list1, które nie są zawarte w żadnej z list list2, list3,…, listN o tym samym typie danych elementu.

Źródła błędów

Aby utworzyć zestaw różnic, typy danych elementów list list2, list3,…, listN muszą być w stanie zostać przekonwertowane na typ danych elementu listy list1. Jeśli na przykład list1 jest zadeklarowana jako Number[], a list2 jako String[], to minus(list1, list2) spowoduje błąd składni, ale minus(list2, list1) nie.

Przykłady

minus(list(1, 2, 3), list(1), list(2)) zwraca listę typu danych Number[] z przecięciem 3 i elementem typu danych Number.

minus(list(1), list(2)) zwraca pustą listę danych typu Number[].

minus(list(„1”), list(1)) zwraca pustą listę danych typu String[].

Kontekst

ALL

Uwagi

Zobacz także

intersection, union

Nazwa

size

Opis

size określa liczbę elementów na liście lub w HashMap.

Podpisy

Number size(Unknown[] list)

Number size(HashMap hashMap)

Parametry

list jest listą.

hashMap to tablica skrótów (HashMap).

Wynik

Liczba elementów na liście list lub w tablicy hash hashMap.

Źródła błędów

Brak

Przykłady

size(list(1, 2, 3)) zwraca 3.

size(new(String[10])) zwraca 10.

size(new(HashMap)) zwraca 0.

Kontekst

ALL

Uwagi

Dwa wyrażenia size(list1) = 0 i isEmpty(list1) sprawdzają, czy lista list1 jest pusta.

Zobacz także

isEmpty

Nazwa

toCharList

Opis

toCharList konwertuje ciąg znaków na listę znaków.

Podpisy

String[] toCharList(String text)

Parametry

text to ciąg znaków.

Wynik

Lista z jednym elementem dla każdego znaku w łańcuchu.

Źródła błędów

Brak

Przykłady

toCharList(„ABC”) zwraca listę zawierającą elementy [„A”], [„B”] i [„C”].

Kontekst

ALL

Uwagi

Zobacz także

Nazwa

union

Opis

union zwraca połączenie dwóch lub więcej list.

Podpisy

Unknown[] union(Unknown[] list1, Unknown[] list2)

Unknown[] union(Unknown[] list1, Unknown[] list2,…,Unknown[] listN)

Parametry

list1 to pierwsza lista.

list2 to druga lista.

listN jest ostatnią listą.

Wynik

Związek przekazanych list jako lista o tym samym typie danych co list1. Zbiór unii składa się ze wszystkich elementów, które są zawarte w jednej z list list1, list2,…, listN i mają ten sam typ danych elementu.

Źródła błędów

Aby utworzyć zbiór unii, typy danych elementów list list2, list3,…, listN muszą być w stanie zostać przekonwertowane na typ danych elementu listy list1. Jeśli na przykład list1 jest zadeklarowana jako Number[], a list2 jako String[], to union(list1, list2) spowoduje błąd składni, ale union(list2, list1) nie.

Przykłady

union(list(1, 2, 3), list(1), list(2)) zwraca listę typu danych Number[] z elementami 1, 2, 3 typu danych Number.

union(list(1), list(2)) zwraca listę typu danych Number[] z elementami 1, 2 typu danych Number.

union(list(„1”), list(1)) zwraca listę typu danych String[] z elementami 1 i 1 odpowiednio typu danych String i Number.

Kontekst

ALL

Uwagi

Zobacz także

add, intersection, minus

Nazwa

guidToString

Opis

guidToString konwertuje identyfikator GUID na ciąg znaków w 37-znakowym formacie Microsoft. Format ten jest używany na przykład przez BIS.

Podpisy

String (Guid guid)

Parametry

guid jest identyfikatorem GUID.

Wynik

Ciąg znaków dla guid w 37-znakowym formacie Microsoft.

Źródła błędów

Brak

Przykłady

guidToString(ZERO_GUID) zwraca 00000000-0000-00-00-00-00-000000000000 jako ciąg znaków.

guidToString(INVALID_GUID) zwraca 00000000-0000-00-00-00-f000000000 jako ciąg znaków.

guidToString(„0040509F68492E10926FAE1BAABC0000“ zwraca 9f504000-4968-102e-92-6f-0000bcaa1bae jako ciąg znaków.

Kontekst

ALL

Uwagi

guidToString należy wykorzystywać tylko wtedy, gdy użytkownik chce przekonwertować guid na 37-cyfrowy format Microsoft.

Aby przekonwertować identyfikator Guid na ciąg znaków, należy użyć funkcji cast. Dla porównania, cast(String, ZERO_GUID) zwraca ciąg znaków z 32 zerami („00000000000000000000000000000000”).

Zobacz także

cast

Nazwa

newGuid

Opis

newGuid tworzy nowy unikalny identyfikator Guid.

Podpisy

Guid newGuid()

Parametry

Brak

Wynik

Nowy, przejrzysty identyfikator

Źródła błędów

Brak

Przykłady

newGuid() zwraca nowy unikalny identyfikator Guid.

Kontekst

ALL

Uwagi

Funkcji newGuid można użyć na przykład do przypisania unikalnej nazwy do pliku, który ma zostać utworzony za pomocą funkcji writeFile.

Zobacz także