DateValue, TimeValue және DateTimeValue функциялары

Мақала
06/10/2024

Қолданылады: Canvas қолданбалары Жұмыс үстелі ағындары Үлгіге негізделген қолданбалар Power Pages Power Platform CLI

Жол ішіндегі күн, уақытты немесе екеуін де күн/уақыт мәніне түрлендіреді.

Сипаттама

DateValue функциясы күн жолын (мысалы, "10/01/2014") күн/уақыт мәніне түрлендіреді.
TimeValue функциясы уақыт жолын (мысалы, "12:15 PM") күн/уақыт мәніне түрлендіреді.
DateTimeValue функциясыкүн мен уақыт жолын (мысалы, "10 қаңтар, 2013 12:13") күн/уақыт мәніне түрлендіреді.

DateValue функциясы күн жолындағы уақыт туралы бүкіл ақпаратты елемейді, ал TimeValue функциясы уақыт жолындағы күн туралы бүкіл ақпаратты елемейді.

Ескертпе

Әдепкі бойынша, DateValue, TimeValue және DateTimeValue функциялары ағымдағы пайдаланушының параметрлердегі тілді пайдаланады. Жолдардың дұрыс түсінілуін қамтамасыз ету үшін мұны қайта анықтауға болады. Мысалы, "10/1/1920" мәні "en" тілінде 1 қазан және "fr" тілінде 10 қаңтар ретінде түсініледі.

Күндер мына пішімдердің бірінде болуы керек:

АА/КК/ЖЖЖЖ немесе АА-КК-ЖЖЖЖ
КК/АА/ЖЖЖЖ немесе КК-АА-ЖЖЖЖ
ЖЖЖЖ/АА/КК немесе ЖЖЖЖ-АА-КК
АА/КК/ЖЖ немесе АА-КК-ЖЖ
КК/АА/ЖЖ немесе КК-АА-ЖЖ
КК Ай ЖЖЖЖ
Ай КК, ЖЖЖЖ

Сандық күн, ай және жыл құрамдастарынан түрлендіру үшін Date бөлімін оқыңыз.
Сандық сағат, минут және секунд құрамдастарынан түрлендіру үшін Time бөлімін оқыңыз.

Қосымша ақпарат алу үшін мынаны оқыңыз:

Синтаксис

DateValue( String [, Language ])
DateTimeValue( String [, Language ])
TimeValue( String [, Language ])

String - Міндетті. Күнді, уақытты немесе күн және уақыт мәндерінің тіркесімін қамтитын мәтін жол.
Language - Міндетті емес. Тіл жолы, мысалы, Language функциясы қайтарған бірінші екі таңба сияқты. Көрсетілмеген болса, ағымдағы пайдаланушы параметрлеріндегі тіл пайдаланылады.

DateValue( Жіктелмеген )
DateTimeValue( Жіктелмеген )
TimeValue( Жіктелмеген )

Untyped - Міндетті. Жіктелмеген нысан - күн немесе уақытты көрсетеді. Қабылданатын мәндер жіктелмеген провайдерге байланысты. JSON үшін жіктелмеген нысан ISO 8601 пішіміндегі күн мен уақытты қамтитын JSON жолы болады деп күтілуде. Басқа пішімдегі күндер немесе уақыттар қатеге әкеледі. Мұндай мәндерді алдымен Мәтінге, содан кейін күнге немесе уақытқа түрлендіруді қарастырыңыз. Уақыт белдеулері мен тілге қатысты пішімдердің сыртқы жүйелермен байланысу кезінде маңызды ескерілетінін есте сақтаңыз.

Мысалдар

DateValue

Startdate деп аталатын мәтінді енгізу басқару элементіне 10/11/2014 мәнін енгізсеңіз, содан кейін белгінің Мәтін сипатын мына формулаларға орнатсаңыз:

Пайдаланушы тіліндегі жолдан күнді түрлендіреді және нәтижені ұзын күн түрінде көрсетеді.
```
Text( DateValue( Startdate.Text ), DateTimeFormat.LongDate )
```
en тіліне орнатылған құрылғы белгіні Сенбі, 11 қазан, 2014 түрінде көрсетеді.

Ескертпе

DateTimeFormat санамалауында бірнеше опцияны пайдалануға болады. Опциялар тізімін көрсету үшін формула жолағында параметрді, одан кейін нүктені (.) теріңіз немесе Text функциясының анықтамасын қараңыз.
Француз тіліндегі жолдан күнді түрлендіреді және нәтижені ұзын күн түрінде көрсетеді. Бұл мысалда, айлар және ай күні ағылшын тілінен басқаша түсініледі.
```
Text( DateValue( Startdate.Text, "fr" ), DateTimeFormat.LongDate )
```
en тіліне орнатылған құрылғы бұл белгіні Дүйсенбі, 10 қараша, 2014 түрінде көрсетеді.

Оның орнына 20 қазан, 2014 деп терсеңіз:

Пайдаланушы тіліндегі жолдан күнді түрлендіреді және екі күн арасындағы айырмашылықты күндер түрінде есептейді
```
DateDiff( DateValue( Startdate.Text ), Today() )
```
en тіліне орнатылған құрылғы бұл белгіні 9 түрінде көрсетеді, осылайша 11 қазан және 20 қазан арасындағы күндер санын көрсетеді. Сондай-ақ DateDiff функциясы айырмашылықты айлар, тоқсандар немесе жылдар түрінде көрсете алады.

DateTimeValue

Start деп аталатын мәтінді енгізу басқару элементінде 10/11/2014 1:50:24.765 PM деп терсеңіз, содан кейін белгінің Мәтін сипатын келесі формулаларға орнатсаңыз:

Ағымдағы тілде күн мен уақыт жолдарының екеуін де түрлендіреді.
```
Text( DateTimeValue( Start.Text ), DateTimeFormat.LongDateTime )
```
en тіліне орнатылған құрылғы белгіні Сенбі, 11 қазан, 2014 1:50:24 PM түрінде көрсетеді.

Ескертпе

DateTimeFormat санамалауында бірнеше опцияны пайдалануға болады. Опциялар тізімін көрсету үшін формула жолағында параметрді, одан кейін нүктені (.) теріңіз немесе Text функциясының анықтамасын қараңыз.
Француз тілінде күн мен уақыт жолдарының екеуін де түрлендіреді. Ай және айдың күні әртүрлі түсініледі.
```
Text( DateTimeValue( Start.Text, "fr"), DateTimeFormat.LongDateTime )
```
en тіліне орнатылған құрылғы белгіні Дүйсенбі, 10 қараша, 2014 1:50:24 PM түрінде көрсетеді.
Пайдаланушы тілінде күн және уақыт жолдарының екеуін де түрлендіріп, нәтижені бөлшектік секундпен бірге көрсетеді.
```
Text( DateTimeValue( Start.Text ), "dddd, mmmm dd, yyyy hh:mm:ss.fff AM/PM" )
```
en тіліне орнатылған құрылғы белгіні Сенбі, 11 қазан, 2014 01:50:24.765 PM түрінде көрсетеді.

Балама ретінде, уақытты секундтың ең жақын 10^-шы немесе 100^-ші бөлігіне дейін дөңгелектеу үшін сс:мм:сс.f немесе сс:мм:сс.ff деп көрсетуге болады.

TimeValue

FinishedAt мәтінді енгізу басқару элементіне атау беріңіз және белгінің Мәтін сипатын мына формулаға орнатыңыз:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)

FinishedAt басқару элементінде 4:59:59.999 PM деп терсеңіз, белгі "Сіз мұны істедіңіз!" жазуын көрсетеді
FinishedAt басқару элементінде 5:00:00.000 PM деп терсеңіз, белгі "Тым кеш!" жазуын көрсетеді

Бөлісу құралы: