Συναρτήσεις DateValue, TimeValue και DateTimeValue

  • Άρθρο

Ισχύει σε: Εφαρμογές καμβά Ροές επιφάνειας εργασίας Εφαρμογές βάσει μοντέλου Power Platform CLI

Μετατρέπει μια ημερομηνία, ώρα ή και τα δύο σε μια συμβολοσειρά σε μια τιμή ημερομηνίας/ώρας.

Περιγραφή

  • Η συνάρτηση DateValue μετατρέπει μια συμβολοσειρά ημερομηνίας (για παράδειγμα, "10/01/2014") σε μια τιμή ημερομηνίας/ώρας.

  • Η συνάρτηση TimeValue μετατρέπει μια συμβολοσειρά ώρας (για παράδειγμα, "12:15 Μ.Μ.") σε μια τιμή ημερομηνίας/ώρας.

  • Η συνάρτηση DateTimeValue μετατρέπει μια συμβολοσειρά ημερομηνίας και ώρας (για παράδειγμα, "10 Ιανουαρίου 2013 12:13 Π.Μ.") σε μια τιμή ημερομηνίας/ώρας.

Η συνάρτηση DateValue αγνοεί οποιεσδήποτε πληροφορίες ώρας στη συμβολοσειρά ημερομηνίας και η συνάρτηση TimeValue αγνοεί οποιεσδήποτε πληροφορίες ημερομηνίας στη συμβολοσειρά ώρας.

Σημείωμα

Οι συναρτήσεις DateValue, TimeValue και DateTimeValue από προεπιλογή χρησιμοποιούν τη γλώσσα από τις ρυθμίσεις του τρέχοντος χρήστη. Μπορείτε να την παρακάμψετε για να διασφαλίσετε ότι οι συμβολοσειρές μεταφράζονται σωστά. Για παράδειγμα, το "10/1/1920" ερμηνεύεται ως 1η Οκτωβρίου στα "en" και ως 10η Ιανουαρίου στα "fr".

Οι ημερομηνίες πρέπει σε μία από τις εξής μορφές:

  • ΜΜ/ΗΗ/ΕΕΕΕ ή ΜΜ-ΗΗ-ΕΕΕΕ
  • ΗΗ/ΜΜ/ΕΕΕΕ ή ΗΗ-ΜΜ-ΕΕΕΕ
  • ΕΕΕΕ/ΜΜ/ΗΗ ή ΕΕΕΕ-ΜΜ-ΗΗ
  • ΜΜ/ΗΗ/ΕΕ ή ΜΜ-ΗΗ-ΕΕ
  • ΗΗ/ΜΜ/ΕΕ ή ΗΗ-ΜΜ-ΕΕ
  • ΗΗ Μήνας ΕΕΕΕ
  • Μήνας ΗΗ, ΕΕΕΕ

Για να μετατρέψετε από αριθμητικά στοιχεία ημερομηνίας, μήνας και έτος, διαβάστε την Date.
Για να μετατρέψετε από αριθμητικά στοιχεία ώρας, λεπτών και δευτερολέπτων, διαβάστε την Time.

Για περισσότερες πληροφορίες, διαβάστε:

Σύνταξη

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

  • String - Υποχρεωτικό. Μια συμβολοσειρά κειμένου που περιέχει μια τιμή ημερομηνίας, ώρας ή συνδυασμό ημερομηνίας και ώρας.
  • Language - Προαιρετικό. Μια συμβολοσειρά γλώσσας, όπως θα επέστρεφε από τους δύο πρώτους χαρακτήρες της συνάρτησης Language. Εάν δεν παρέχεται, χρησιμοποιείται η γλώσσα των ρυθμίσεων του τρέχοντος χρήστη.

DateValue( Untyped )
DateTimeValue( Untyped )
TimeValue( Untyped )

  • Untyped - Υποχρεωτικό. Μη πληκτρολογημένο αντικείμενο που αναπαριστά μια ημερομηνία ή ώρα. Οι αποδεκτές τιμές εξαρτώνται από τον μη πληκτρολογημένο πάροχο. Για JSON, το μη πληκτρολογημένο αντικείμενο αναμένεται να είναι μια συμβολοσειρά JSON που περιέχει μια ημερομηνία και ώρα σε μορφή ISO 8601. Οι ημερομηνίες ή οι ώρες σε άλλες μορφές θα έχουν ως αποτέλεσμα σφάλμα. Εξετάστε το ενδεχόμενο να μετατρέψετε αυτές τις τιμές σε Κείμενο πρώτα και μετά σε ημερομηνία ή ώρα. Λάβετε υπόψη σας ότι οι ζώνες ώρας και οι μορφές που σχετίζονται με τις τοπικές ρυθμίσεις είναι σημαντικά ζητήματα κατά την επικοινωνία με εξωτερικά συστήματα.

Παραδείγματα

DateValue

Εάν πληκτρολογήσατε 10/11/2014 σε ένα στοιχείο ελέγχου εισαγωγής κειμένου με την ονομασία Startdate και, στη συνέχεια, ορίσατε την ιδιότητα Text μιας ετικέτας σε αυτούς τους τύπους:

  • Μετατρέψτε μια ημερομηνία από μια συμβολοσειρά στις τοπικές ρυθμίσεις του χρήστη και εμφανίστε το αποτέλεσμα ως μεγάλη ημερομηνία.

    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

Εάν πληκτρολογήσατε 10/11/2014 1:50:24.765 Μ.Μ. σε ένα στοιχείο ελέγχου εισαγωγής κειμένου με την ονομασία Start και, στη συνέχεια, ορίσατε την ιδιότητα Text μιας ετικέτας στον ακόλουθο τύπο:

  • Μετατρέψτε και τις δύο συμβολοσειρές ημερομηνίας και ώρας στις τρέχουσες τοπικές ρυθμίσεις.

    Text( DateTimeValue( Start.Text ), DateTimeFormat.LongDateTime )

    Η ρύθμιση συσκευής στις τοπικές ρυθμίσεις en εμφανίζει την ετικέτα ως Σάββατο, 11 Οκτωβρίου 2014 1:50:24 μ.μ..

    Σημείωμα

    Μπορείτε να χρησιμοποιήσετε διάφορες επιλογές με την απαρίθμηση DateTimeFormat. Για να εμφανίσετε μια λίστα επιλογών, πληκτρολογήστε την παράμετρο ακολουθούμενη από μια κουκκίδα ή μια τελεία (.) στη γραμμή τύπων ή ελέγξτε την αναφορά συναρτήσεων Text.

  • Μετατρέψτε και τις δύο συμβολοσειρές ημερομηνίας και ώρας στις γαλλικές τοπικές ρυθμίσεις. Ο μήνας και η ημέρα του μήνα ερμηνεύονται διαφορετικά.

    Text( DateTimeValue( Start.Text, "fr"), DateTimeFormat.LongDateTime )

    Η ρύθμιση συσκευής στις τοπικές ρυθμίσεις en εμφανίζει την ετικέτα ως Δευτέρα, 10 Νοεμβρίου 2014 1:50:24 μ.μ..

  • Μετατρέψτε μια συμβολοσειρά ημερομηνίας και ώρας στις τοπικές ρυθμίσεις του χρήστη και εμφανίστε το αποτέλεσμα με ένα κλασματικό δευτερόλεπτο.

    Text( DateTimeValue( Start.Text ), "dddd, mmmm dd, yyyy hh:mm:ss.fff AM/PM" )

    Η ρύθμιση συσκευής στις τοπικές ρυθμίσεις en εμφανίζει την ετικέτα ως Σάββατο, 11 Οκτωβρίου 2014 01:50:24.765 μ.μ..

    Ως εναλλακτική, μπορείτε να ορίσετε το hh:mm:ss.f ή hh:mm:ss.ff για στρογγυλοποίηση της ώρας στο πλησιέστερο 10ο ή 100ο του δευτερολέπτου.

TimeValue

Ονομάστε ένα στοιχείο ελέγχου εισαγωγής κειμένου FinishedAt και ορίστε την ιδιότητα Text μιας ετικέτας σε αυτόν τον τύπο:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • Εάν πληκτρολογήσατε 4:59:59.999 Μ.Μ. στο στοιχείο ελέγχου FinishedAt, η ετικέτα δείχνει "Τα καταφέρατε!"
  • ++Εάν πληκτρολογήσατε 5:00:00.000 Μ.Μ. στο στοιχείο ελέγχου FinishedAt, η ετικέτα δείχνει "Πολύ αργά!"