Salesforce Apex – formát dátumu

Sledovanie podrobností o zákazníkoch v účtoch/kontaktoch je veľmi dôležité pri riadení vzťahov so zákazníkmi (CRM). Na základe dátumu prebiehajú všetky procesy, ako je nákup, cenová ponuka a servis. Pozrime sa, ako vytvoriť dátum z reťazca v Salesforce a previesť dátum na reťazec. V rámci tohto tutoriálu tiež uvidíme metódy, ktoré sa používajú pri naformátovanom dátume, ako je pridávanie dní, rokov, mesiacov atď., s príkladmi.

Trieda Apex Date

Trieda dátumu podporuje všetky metódy dátumu, ktoré sú primitívne. Používa menný priestor „System“. Na konverziu reťazca do formátu dátumu môžeme použiť metódu valueOf() z tejto triedy. Po naformátovaní dátumu použijeme niektoré metódy na pridanie dní, mesiacov, rokov atď. k tomuto naformátovanému dátumu pomocou niektorých metód, ktoré sú tiež dostupné v tejto triede dátumu.

Najprv uvidíme, ako previesť reťazec na dátum pomocou metódy valueOf() v Salesforce Apex.

Date.valueOf()

Hodnota valueOf() v Apex je dostupná v triede „Date“, ktorá berie reťazec ako argument, ktorý prevádza zadaný reťazec do formátu dátumu. Vstupný reťazec (parameter) obsahuje tri atribúty – rok, mesiac a deň. Všetky tieto tri sa kombinujú/spájajú a prechádzajú do metódy.

Syntax: ValueOf()

Ako už bolo spomenuté, musíme deklarovať premennú triedy „Date“ a odovzdať jej reťazec.

Príklad:

Krok 1:

Majme reťazec, ktorý obsahuje „rok-mesiac-deň“.

Výkon:

Krok 2:

Teraz preveďte predchádzajúci reťazec „Date“ na „Date“ pomocou metódy valueOf() z triedy Apex „Date“.

Výkon:

Vidíme, že po konverzii na „Dátum“ automaticky vráti dátum vo formáte DateTime. Neberie do úvahy čas (hodiny:minúty:sekundy), aj keď ich prenesiete do metódy valueOf(). Vrátený formát je RRRR-MM-DD HH:MM:SS.

Preveďte dátum na reťazec

Existujú dva spôsoby, ako previesť „Dátum“ na „Reťazec“. Jedným zo spôsobov, ktorý Apex podporuje, je použitie metódy format(). Druhým spôsobom je manuálne extrahovanie atribútov „Dátum“ (rok, mesiac a deň) a ich zreťazenie do reťazca. Pozrime sa na ne jeden po druhom.

1. Format()

Metóda format() je dostupná v triede „Date“ v Apex, ktorá konvertuje „Date“ na reťazec vo formáte „M/D/YYYY“. Tejto metóde môžeme tiež odovzdať zadaný formát ako parameter. Zadaný formát je predvolený formát.

Syntax:

Príklad:

Zoberme si predchádzajúci príklad a pomocou metódy format() skonvertujeme späť „Dátum“ na „String“. Metóde format() neposkytujeme žiadny konkrétny formát.

Výkon:

2. Použitie metódy triedy dátumu

V tomto scenári extrahujeme rok, mesiac a deň oddelene od „Dátumu“ pomocou dostupných metód v triede Apex „Dátum“. Ďalej tieto tri zreťazíme, aby sme vrátili „Dátum“ vo formáte „String“.

1. deň () – Táto metóda sa používa na extrakciu dátumu z „Dátumu“. Vráti celé číslo, ktoré určuje dátum.
2. mesiac() – Táto metóda sa používa na extrakciu mesiaca z „Dátumu“. Vráti celé číslo, ktoré určuje číslo mesiaca. Môžeme označovať január ako 1, február ako 2…. decembra ako 12.
3. rok() – Táto metóda sa používa na extrakciu roku z „Dátumu“. Vracia rok v štvorcifernom formáte.

Syntax:

Príklad:

Preveďte späť „Dátum“ na „Reťazec“ vo formáte „RRRR-M-D“.

Výkon:

Praktické príklady:

Pozrime sa, ako aktualizovať „Dátum“, napríklad pridať dni, roky a mesiace k existujúcemu dátumu v objektoch Salesforce. Všetky tri metódy berú ako argument celé číslo „n“.

1. addDays()

Ak chcete pridať dni k existujúcemu dátumu, Apex podporuje metódu addDays(), ktorá je dostupná v triede „Date“.

2. addMonths()

Ak chcete pridať mesiace k existujúcemu dátumu, Apex podporuje metódu addMonths(), ktorá je dostupná v triede „Date“.

3. addYears()

Ak chcete pridať roky k existujúcemu dátumu, Apex podporuje metódu addYears(), ktorá je dostupná v triede „Dátum“.

Syntax:

Pozrime sa na syntax týchto troch metód. Tu „n“ predstavuje celočíselnú hodnotu.

• input_Date.addDays(n)
• input_Date.addMonths(n)
• input_Date.addYears(n)

Predtým, ako prejdete na príklad, zvážte nasledujúce:

1. Prihláste sa do Salesforce a prejdite na „Spúšťač aplikácií“ a na karte vyhľadajte „Kampaň“. Tu vložíme „Názov kampane“ a „Dátum ukončenia“.

1. Vyberte „Kampane“ a kliknite na „Nové“.

1. Zobrazí sa kontextové okno na vloženie údajov do kampane. Pridajte „Linux Hint Posts“ pod „Campaign Name“ a nastavte „End Date“ na 4/5/2023. Potom kliknite na „Uložiť“.

So záznamom sme pripravení. (Typ – Konferencia a Stav – Plánované príde automaticky. Nechajte tak). Otvorme anonymné okno v konzole pre vývojárov.

Príklad 1:

Použime metódu addDays() na pridanie 10 dní k existujúcemu dátumu „End Date“ v objekte „Campaign“.

1. Aby sme to dosiahli, musíme najprv použiť dotaz SOQL na získanie záznamu z objektu „Campaign“ a uložiť tento záznam do objektu „List“.
2. Ďalej použijeme cyklus „for“ na iteráciu zoznamu a metódu addDays() na pridanie 10 dní k „Dátumu ukončenia“.
3. Nakoniec použijeme príkaz „update DML“ na aktualizáciu „Dátumu ukončenia“ v objekte „Campaign“.