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

Мақала
10/16/2024

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

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

Сипаттама

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

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

Ескертпе

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

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

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

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

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

Синтаксис

DateValue( Жол [, Тіл ])
DateTimeValue( Жол [, Тіл ])
Уақыт мәні( Жол [, Тіл ])

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

DateValue( Типі жазылмаған )
DateTimeValue( Типтелмеген )
Уақыт мәні( Типі жазылмаған )

Терілмеген - Міндетті. жіктелмеген нысан күнді немесе уақытты білдіреді. Қабылданатын мәндер жіктелмеген провайдерге байланысты. 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 деп терсеңіз, белгі "Тым кеш!" жазуын көрсетеді

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