DATETIMEVALUE ER-funktio
DATETIMEVALUE -funktio palauttaa Päivämäärä/aika -arvon, joka muunnetaan tietystä tekstiarvosta tekstinä määritetyssä muodossa ja valinnaisesti määritetyssä kulttuurissa päivämäärä-/aika-arvoksi. Lisätietoja tuetuista muodoista on kohdassa vakio ja mukautettu.
Syntaksi 1
DATETIMEVALUE (text, format)
Syntaksi 2
DATETIMEVALUE (text, format, culture)
Argumentit
text: Merkkijono
Teksti, joka vastaa muokattavaa arvoa.
format: Merkkijono
Annetun tekstin muoto. Lisätietoja tuetuista muodoista on kohdassa vakio ja mukautettu.
culture: Merkkijono
Tietyn tekstin muotoilussa käytettävä kulttuuri. Lisätietoja tuetuista kulttuureista on kohdassa kulttuuri.
Palautusarvot
Päivämäärä ja aika
Tulokseksi saatava päivämäärä-/aika-arvo.
Käyttöhuomautukset
Kun kulttuuria ei ole määritetty kutsutun funktion argumentiksi, kutsuvan kontekstin määrittämä arvo culture määritetään. Jos DATETIMEVALUE-funktiota kutsutaan esimerkiksi käyttämällä syntaksia 1 sähköisen raportoinnin (ER) muodossa TIEDOSTO-elementille, joka on määritetty käyttämään Saksan kulttuuria, muuntaminen tehdään Saksan kulttuurin avulla. culture-arvon oletusarvo on FI-FI.
Esimerkki 1
DATETIMEVALUE ("21-Dec-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss") palauttaa arvon 2:55:00 am 21. joulukuuta 2016, joka perustuu määritettyyn mukautettuun muotoon ja oletussovelluksen EN-US -kulttuuriin.
Esimerkki 2
DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", "IT") palauttaa arvon 2:55:00 AM 21. joulukuuta 2016 perustuen määritettyyn mukautettuun muotoon ja kulttuuriin.
Kuitenkin DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", "EN-US") aiheuttaa poikkeuksen, joka ilmoittaa käyttäjälle, että määritettyä merkkijonoa ei tunnisteta kelvolliseksi päivämäärä-/aika-arvoksi tietylle kulttuurille.