Τυπικές συμβολοσειρές μορφής ημερομηνίας και ώρας
Μια τυπική συμβολοσειρά μορφής ημερομηνίας και ώρας χρησιμοποιεί έναν μόνο χαρακτήρα ως το προσδιοριστικό μορφής για να ορίσει την αναπαράσταση κειμένου μιας τιμής ώρας και ημερομηνίας. Οποιαδήποτε συμβολοσειρά μορφής ημερομηνίας και ώρας που περιέχει περισσότερους από έναν χαρακτήρες, συμπεριλαμβανομένου του λευκού διαστήματος, ερμηνεύεται ως προσαρμοσμένη συμβολοσειρά μορφής ημερομηνίας και ώρας. Μια συμβολοσειρά τυπικής ή προσαρμοσμένης μορφής μπορεί να χρησιμοποιηθεί για τον ορισμό της αναπαράστασης κειμένου που προκύπτει από μια λειτουργία μορφοποίησης.
Πίνακας προσδιοριστών μορφοποίησης
Ο παρακάτω πίνακας περιγράφει τα τυπικά προσδιοριζόμενα μορφής ημερομηνίας και ώρας.
Προσδιοριστικό μορφοποίησης | Περιγραφή | Παραδείγματα |
---|---|---|
"d" | Μοτίβο σύντομης ημερομηνίας. Περισσότερες πληροφορίες: Το προσδιοριστικό μορφής σύντομης ημερομηνίας ("d"). |
2009-06-15T13:45:30 -> 6/15/2009 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 (fr-FR) 2009-06-15T13:45:30 -> 2009/06/15 (ja-JP) |
"D" | Μοτίβο μεγάλης ημερομηνίας. Περισσότερες πληροφορίες: Το προσδιοριστικό μορφής μεγάλης ημερομηνίας ("D"). |
2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 (en-US) 2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (ru-RU) 2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE) |
"f" | Μοτίβο πλήρους ημερομηνίας/ώρας (σύντομη ώρα). Περισσότερες πληροφορίες: Το προσδιοριστικό μορφής πλήρους ημερομηνίας σύντομης ώρας ("f"). |
2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μ.μ. (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE) 2009-06-15T13:45:30 -> Αποζημιωτικά, 15 Εκ. 2009 1:45 μμ (el-GR) |
"F" | Μοτίβο πλήρους ημερομηνίας/ώρας (μεγάλη ώρα). Περισσότερες πληροφορίες: Το προσδιοριστικό μορφής πλήρους ημερομηνίας ("F"). |
2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μ.μ. (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE) 2009-06-15T13:45:30 -> Ονομαστική, 15 Ιωαννία 2009 1:45:30 μμ (el-GR) |
"g" | Γενικό μοτίβο ημερομηνίας/ώρας (σύντομο χρονικό διάστημα). Περισσότερες πληροφορίες: Το προσδιοριστικό μορφής γενικής ημερομηνίας σύντομης ώρας ("g"). |
2009-06-15T13:45:30 -> 6/15/2009 1:45 Μ.Μ. (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN) |
"G" | Γενικό μοτίβο ημερομηνίας/ώρας (μεγάλη ώρα). Περισσότερες πληροφορίες: Το προσδιοριστικό μορφής γενικής ημερομηνίας ("G"). |
2009-06-15T13:45:30 -> 6/15/2009 1:45:30 Μ.Μ. (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN) |
"M", "m" | Μοτίβο μήνα/ημέρας. Περισσότερες πληροφορίες: Το προσδιοριστικό μορφής μήνα ("M", "m"). |
2009-06-15T13:45:30 -> 15 Ιουνίου (en-US) 2009-06-15T13:45:30 -> 15. juni (da-DK) 2009-06-15T13:45:30 -> 15 Juni (id-ID) |
"O", "o" | μοτίβο ημερομηνίας/ώρας επιστροφής/ώρας. Περισσότερες πληροφορίες: Το προσδιοριστικό μορφής τύπου "O", "o"). |
2009-06-15T13:45:30 (Τοπικές) --> 2009-06-15T13:45:30.000000-07:00 2009-06-15T13:45:30 (Utc) --> 2009-06-15T13:45:30.000000+00:00 2009-06-15T13:45:30 (Μη καθορισμένο) --> 2009-06-15T13:45:30.0000000 |
"R", "r" | RFC1123 μοτίβο. Περισσότερες πληροφορίες: Το προσδιοριστικό μορφής RFC1123 ("R", "r"). |
2009-06-15T13:45:30 -> Δευ, 15 Ιουν 2009 13:45:30 GMT |
"s" | Μοτίβο ημερομηνίας/ώρας με δυνατότητα ταξινόμησης. Περισσότερες πληροφορίες: Το προσδιοριστικό μορφής με δυνατότητα ταξινόμησης ("s"). |
2009-06-15T13:45:30 (Τοπικές) -> 2009-06-15T13:45:30 2009-06-15T13:45:30 (Utc) -> 2009-06-15T13:45:30 |
"t" | Μοτίβο σύντομου χρόνου. Περισσότερες πληροφορίες: Το προσδιοριστικό μορφής σύντομου χρόνου ("t"). |
2009-06-15T13:45:30 -> 1:45 Μ.Μ. (en-US) 2009-06-15T13:45:30 -> 13:45 (hr-HR) 2009-06-15T13:45:30 -> 01:45 م (ar-EG) |
"T" | Μοτίβο μεγάλης χρονικής διάρκειας. Περισσότερες πληροφορίες: Το προσδιοριστικό μορφής μεγάλης διάρκειας ("T"). |
2009-06-15T13:45:30 -> 1:45:30 Μ.Μ. (en-US) 2009-06-15T13:45:30 -> 13:45:30 (hr-HR) 2009-06-15T13:45:30 -> 01:45:30 م (ar-EG) |
"u" | Καθολικό μοτίβο ημερομηνίας/ώρας με δυνατότητα ταξινόμησης. Περισσότερες πληροφορίες: Το καθολικό προσδιοριστικό μορφής με δυνατότητα ταξινόμησης ("u"). |
2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z |
"Y", "y" | Μοτίβο μήνα έτους. Περισσότερες πληροφορίες: Το προσδιοριστικό μορφής μήνα έτους ("Y"). |
2009-06-15T13:45:30 -> Ιούνιος 2009 (en-US) 2009-06-15T13:45:30 -> juni 2009 (da-DK) 2009-06-15T13:45:30 -> Juni 2009 (id-ID) |
Οποιοσδήποτε άλλος χαρακτήρας | Άγνωστο προσδιοριστικό. | Εμφανίζει ένα σφάλμα παράστασης χρόνου εκτέλεσης. |
Πώς λειτουργούν οι τυπικές συμβολοσειρές μορφής
Σε μια λειτουργία μορφοποίησης, μια τυπική συμβολοσειρά μορφής είναι απλώς ένα ψευδώνυμο για μια συμβολοσειρά προσαρμοσμένης μορφής. Το πλεονέκτημα της χρήσης ενός ψευδώνυμου για αναφορά σε μια συμβολοσειρά προσαρμοσμένης μορφής είναι ότι, παρόλο που το ψευδώνυμο παραμένει αμετάβλητο, η ίδια η συμβολοσειρά προσαρμοσμένης μορφής μπορεί να διαφέρει. Αυτό είναι σημαντικό καθώς οι αναπαραστάσεις συμβολοσειρών των τιμών ημερομηνίας και ώρας συνήθως διαφέρουν ανάλογα με την κουλτούρα. Για παράδειγμα, η συμβολοσειρά τυπικής μορφής "d" υποδεικνύει ότι μια τιμή ημερομηνίας και ώρας θα εμφανίζεται με ένα σύντομο μοτίβο ημερομηνίας. Για την αμετάβλητη κουλτούρα, αυτό το μοτίβο είναι "ΜΜ/ηη/εεεε". Για την κουλτούρα fr-FR, είναι "dd/MM/yyyy". Για την κουλτούρα ja-JP, είναι "εεεε/ΜΜ/ηη".
Εάν μια συμβολοσειρά τυπικής μορφής σε μια λειτουργία μορφοποίησης αντιστοιχίζεται στην προσαρμοσμένη συμβολοσειρά μορφής μιας συγκεκριμένης κουλτούρας, η εφαρμογή σας μπορεί να καθορίσει τη συγκεκριμένη κουλτούρα της οποίας οι συμβολοσειρές προσαρμοσμένης μορφής χρησιμοποιούνται με έναν από τους εξής τρόπους:
Μπορείτε να χρησιμοποιήσετε την προεπιλεγμένη (ή την τρέχουσα) κουλτούρα. Το παρακάτω παράδειγμα εμφανίζει μια ημερομηνία χρησιμοποιώντας τη μορφή σύντομης ημερομηνίας της τρέχουσας κουλτούρας. Σε αυτή την περίπτωση, η τρέχουσα κουλτούρα είναι en-US.
let Source = { Date.ToText(#date(2024, 3, 15), [Format = "d"]) //Displays 3/15/2024 } in Source
Μπορείτε να περάσετε μια κουλτούρα που χρησιμοποιείται για τη μορφοποίηση της ημερομηνίας σύμφωνα με τους κανόνες αυτής της συγκεκριμένης κουλτούρας. Το παρακάτω παράδειγμα εμφανίζει μια ημερομηνία που χρησιμοποιεί τη μορφή σύντομης ημερομηνίας της κουλτούρας pt-BR.
let Source = { Date.ToText(#date(2024, 3, 15), [Format = "d", Culture = "pt-BR"]) //Displays 15/03/2024 } in Source
Σε ορισμένες περιπτώσεις, η συμβολοσειρά τυπικής μορφής χρησιμεύει ως βολική συντομογραφία για μια συμβολοσειρά μεγαλύτερης προσαρμοσμένης μορφής που είναι αμετάβλητη. Τέσσερις τυπικές συμβολοσειρές μορφής εμπίπτουν σε αυτή την κατηγορία: "O" (ή "o"), "R" (ή "r"), "s" και "u". Αυτές οι συμβολοσειρές αντιστοιχούν σε συμβολοσειρές προσαρμοσμένης μορφής που ορίζονται από την αμετάβλητη κουλτούρα. Παράγουν αναπαραστάσεις συμβολοσειρών τιμών ημερομηνίας και ώρας που προορίζονται να είναι πανομοιότυπες μεταξύ των πολιτισμών. Ο παρακάτω πίνακας παρέχει πληροφορίες σχετικά με αυτές τις τέσσερις τυπικές συμβολοσειρές μορφής ημερομηνίας και ώρας.
Τυπική συμβολοσειρά μορφής | Καθορίζεται από | Προσαρμοσμένη συμβολοσειρά μορφής |
---|---|---|
"O" ή "o" | Κανένα | yyyy'-'MM'-'dd'T'HH':'mm':'ss'.' fffffffK |
"R" ή "r" | Προδιαγραφή RFC 1123 IETF | ddd, dd MMM yyyy HH':'mm':'s 'GMT' |
"s" | ISO 8601 | yyyy'-'MM'-'dd'T'HH':'mm':ss |
"u" | Με δυνατότητα ταξινόμησης, επειδή χρησιμοποιεί μηδενικά στην αρχή για έτος, μήνα, ημέρα, ώρα, λεπτό και δευτερόλεπτο | yyyy'-'MM'-'dd HH':'mm':'ss'Z' |
Οι τυπικές συμβολοσειρές μορφής μπορούν επίσης να χρησιμοποιηθούν σε λειτουργίες ανάλυσης, οι οποίες απαιτούν μια συμβολοσειρά εισόδου για να συμμορφώνεται ακριβώς με ένα συγκεκριμένο μοτίβο για να επιτύχει η λειτουργία ανάλυσης. Πολλές συμβολοσειρές τυπικής μορφής αντιστοιχιστούν σε πολλές προσαρμοσμένες συμβολοσειρές μορφής, έτσι ώστε μια τιμή ημερομηνίας και ώρας να μπορεί να αναπαριστούν σε διάφορες μορφές και η λειτουργία ανάλυσης να εξακολουθεί να επιτυγχάνει.
Οι παρακάτω ενότητες περιγράφουν τα προσδιοριζόμενα τυπικά προσδιοριζόμενα μορφή για τιμές ημερομηνίας, ημερομηνίας/ώρας, ζώνης ημερομηνίας/ώρας και ώρας .
Μορφές ημερομηνίας
Αυτή η ομάδα περιλαμβάνει τις ακόλουθες μορφές:
- Το προσδιοριστικό μορφής σύντομης ημερομηνίας ("d")
- Το προσδιοριστικό μορφής μεγάλης ημερομηνίας ("D")
Το προσδιοριστικό μορφής σύντομης ημερομηνίας ("d")
Το προσδιοριστικό τυπικής μορφής "d" αντιπροσωπεύει μια προσαρμοσμένη μορφή ημερομηνίας που ορίζεται από μια συγκεκριμένη κουλτούρα. Για παράδειγμα, το κείμενο προσαρμοσμένης μορφής που επιστρέφεται από την αμετάβλητη κουλτούρα είναι "ΜΜ/ηη/εεεε".
Το παρακάτω παράδειγμα χρησιμοποιεί το προσδιοριστικό μορφής "d" για την εμφάνιση μιας τιμής ημερομηνίας.
let
Source =
{
Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = ""]),
// Displays 04/10/2024
Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = "en-US"]),
// Displays 4/10/2024
Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = "en-NZ"]),
// Displays 10/4/2024
Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = "de-DE"])
// Displays 10.4.2024
}
in
Source
Το προσδιοριστικό μορφής μεγάλης ημερομηνίας ("D")
Το προσδιοριστικό τυπικής μορφής "D" αντιπροσωπεύει μια προσαρμοσμένη μορφή ημερομηνίας που ορίζεται από μια συγκεκριμένη κουλτούρα. Για παράδειγμα, η συμβολοσειρά προσαρμοσμένης μορφής για την αμετάβλητη κουλτούρα είναι "dddd, dd MMMM εεεε".
Το παρακάτω παράδειγμα χρησιμοποιεί το προσδιοριστικό μορφής "D" για την εμφάνιση μιας τιμής ημερομηνίας και ώρας.
let
Source =
{
Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = ""]),
// Displays Wednesday, 10 April, 2024
Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = "en-US"]),
// Displays Wednesday, April 10, 2024
Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = "pt-BR"]),
// Displays quarta-feira, 10 de abril de 2024
Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = "es-MX"])
// Displays miércoles, 10 de abril de 2024
}
in
Source
Μορφές ημερομηνίας και ώρας
Αυτή η ομάδα περιλαμβάνει τις ακόλουθες μορφές:
- Το προσδιοριστικό μορφής πλήρους ημερομηνίας σύντομης ώρας ("f")
- Το προσδιοριστικό μορφής πλήρους ημερομηνίας ("F")
- Το προσδιοριστικό μορφής γενικής ημερομηνίας σύντομης ώρας ("g")
- Το προσδιοριστικό μορφής γενικής ημερομηνίας μεγάλης ώρας ("G")
- Το προσδιοριστικό μορφής μετ 'επιστροφής ("O", "o")
- Το προσδιοριστικό μορφής RFC1123 ("R", "r")
- Το προσδιοριστικό μορφής με δυνατότητα ταξινόμησης ("s")
- Το καθολικό προσδιοριστικό μορφής με δυνατότητα ταξινόμησης ("u")
Το προσδιοριστικό μορφής πλήρους ημερομηνίας σύντομης ώρας ("f")
Το προσδιοριστικό τυπικής μορφής "f" αντιπροσωπεύει έναν συνδυασμό των μοτίβων μεγάλης ημερομηνίας ("D") και σύντομης ώρας ("t"), διαχωρισμένα με ένα κενό διάστημα.
Η συμβολοσειρά αποτελέσματος επηρεάζεται από τις πληροφορίες μορφοποίησης μιας συγκεκριμένης κουλτούρας.
Το παρακάτω παράδειγμα χρησιμοποιεί το προσδιοριστικό μορφής "f" για την εμφάνιση μιας τιμής ημερομηνίας και ώρας.
let
Source =
{
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "f", Culture = "en-US"]),
// Displays Wednesday, April 10, 2024 6:30 AM
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "f", Culture = "fr-FR"])
// Displays mercredi 10 avril 2024 06:30
}
in
Source
Το προσδιοριστικό μορφής πλήρους ημερομηνίας ("F")
Το προσδιοριστικό τυπικής μορφής "F" αντιπροσωπεύει μια προσαρμοσμένη μορφή ημερομηνίας και ώρας που ορίζεται από μια συγκεκριμένη κουλτούρα. Για παράδειγμα, η συμβολοσειρά προσαρμοσμένης μορφής για την αμετάβλητη κουλτούρα είναι "dddd, dd MMMM εεεε HH:mm:ss".
Η συμβολοσειρά αποτελέσματος επηρεάζεται από τις πληροφορίες μορφοποίησης μιας συγκεκριμένης κουλτούρας.
Το παρακάτω παράδειγμα χρησιμοποιεί το προσδιοριστικό μορφής "F" για την εμφάνιση μιας τιμής ημερομηνίας και ώρας.
let
Source =
{
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "F", Culture = ""]),
// Displays Wednesday, 10 April, 2024 06:30:00
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "F", Culture = "en-US"]),
// Displays Wednesday, April 10, 2024 6:30:00 AM
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "F", Culture = "fr-FR"])
// Displays mercredi 10 avril 2024 06:30:00
}
in
Source
Το προσδιοριστικό μορφής γενικής ημερομηνίας σύντομης ώρας ("g")
Το προσδιοριστικό τυπικής μορφής "g" αντιπροσωπεύει έναν συνδυασμό μοτίβων σύντομης ημερομηνίας ("d") και σύντομης ώρας ("t"), διαχωρισμένα με ένα κενό διάστημα. Το κείμενο που προκύπτει επηρεάζεται από τις πληροφορίες μορφοποίησης μιας συγκεκριμένης κουλτούρας.
Η συμβολοσειρά αποτελέσματος επηρεάζεται από τις πληροφορίες μορφοποίησης μιας συγκεκριμένης κουλτούρας.
Το παρακάτω παράδειγμα χρησιμοποιεί το προσδιοριστικό μορφής "g" για την εμφάνιση μιας τιμής ημερομηνίας και ώρας.
let
Source =
{
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "g", Culture = ""]),
// Displays 04/10/2024 06:30
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "g", Culture = "en-US"]),
// Displays 4/10/2024 6:30 AM
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "g", Culture = "fr-BE"])
// Displays 10-04-24 06:30
}
in
Source
Το προσδιοριστικό μορφής γενικής ημερομηνίας μεγάλης ώρας ("G")
Το προσδιοριστικό τυπικής μορφής "G" αντιπροσωπεύει έναν συνδυασμό μοτίβων σύντομης ημερομηνίας ("d") και μεγάλης χρονικής διάρκειας ("T"), διαχωρισμένα με ένα κενό διάστημα. Το κείμενο που προκύπτει επηρεάζεται από τις πληροφορίες μορφοποίησης μιας συγκεκριμένης κουλτούρας.
Η συμβολοσειρά αποτελέσματος επηρεάζεται από τις πληροφορίες μορφοποίησης μιας συγκεκριμένης κουλτούρας.
Το παρακάτω παράδειγμα χρησιμοποιεί το προσδιοριστικό μορφής "G" για την εμφάνιση μιας τιμής ημερομηνίας και ώρας.
let
Source =
{
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "G", Culture = ""]),
// Displays 04/10/2024 06:30:00
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "G", Culture = "en-US"]),
// Displays 4/10/2024 6:30:00 AM
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "G", Culture = "nl-BE"])
// Displays 10/04/2024 6:30:00
}
in
Source
Το προσδιοριστικό μορφής μετ 'επιστροφής ("O", "o")
Το προσδιοριστικό τυπικής μορφής "O" ή "o" αντιπροσωπεύει μια προσαρμοσμένη συμβολοσειρά μορφής ημερομηνίας και ώρας, χρησιμοποιώντας ένα μοτίβο που διατηρεί πληροφορίες ζώνης ώρας και εκπέμπει μια συμβολοσειρά αποτελέσματος που συμμορφώνεται με το ISO 8601. Για τις τιμές ζώνης ημερομηνίας/ ώρας, αυτό το προσδιοριστικό μορφής έχει σχεδιαστεί για τη διατήρηση τιμών ημερομηνίας, ώρας και ζώνης ώρας στο κείμενο.
Το προσδιοριστικό τυπικής μορφής "O" ή "o" αντιστοιχεί στο "yyyy'-'MM'-'dd'T'HH':'mm'ss'.' fffffffxxx" προσαρμοσμένη συμβολοσειρά μορφής για τιμές ζώνης ημερομηνίας/ ώρας. Σε αυτό το κείμενο, τα ζεύγη μονών εισαγωγικών που οριοθετούν μεμονωμένους χαρακτήρες, όπως ενωτικά, άνω και κάτω τελεία και το γράμμα "T", υποδεικνύουν ότι ο μεμονωμένος χαρακτήρας είναι μια λεκτική σταθερά που δεν μπορεί να αλλάξει. Οι αποστρόφοι δεν εμφανίζονται στη συμβολοσειρά εξόδου.
Το προσδιοριστικό τυπικής μορφής "O" ή "o" (και το "yyyy'-'MM'-'dd'T'HH':'mm'ss''.' Η προσαρμοσμένη μορφή fffffffxxx) εκμεταλλεύεται τους τρόπους με τους οποίους το ISO 8601 αντιπροσωπεύει τις πληροφορίες ζώνης ώρας για τη διατήρηση των τιμών ζώνης ημερομηνίας/ώρας:
Το στοιχείο ζώνης ώρας DateTimeZone.ToLocal τιμές ημερομηνίας και ώρας είναι μια μετατόπιση από την UTC (για παράδειγμα, +01:00, -07:00).
Το στοιχείο ζώνης ώρας του DateTimeZone.ToUtc τιμές ημερομηνίας και ώρας χρησιμοποιεί +00,00 για την αναπαράσταση της ώρας UTC.
Επειδή το προσδιοριστικό τυπικής μορφής "O" ή "o" συμμορφώνεται με ένα διεθνές πρότυπο, η λειτουργία μορφοποίησης ή ανάλυσης που χρησιμοποιεί το προσδιοριστικό χρησιμοποιεί πάντα την αμετάβλητη κουλτούρα και το γρηγοριανό ημερολόγιο.
Το παρακάτω παράδειγμα χρησιμοποιεί το προσδιοριστικό μορφής "o" για να εμφανίσει μια σειρά τιμών ζώνης ημερομηνίας/ ώρας σε ένα σύστημα στη ζώνη ώρας Ειρηνικού Η.Π.Α.
let
date1 = #datetimezone(2024, 6, 15, 13, 45, 30, 0, 0),
Source =
{
Text.Format("#{0} (Unspecified) --> #{1}", {date1, DateTimeZone.ToText(date1, [Format = "O"])}),
Text.Format("#{0} (Utc) --> #{1}", {date1, DateTimeZone.ToText(DateTimeZone.ToUtc(date1), [Format = "O"])}),
Text.Format("#{0} (Local) --> #{1}", {date1, DateTimeZone.ToText(DateTimeZone.ToLocal(date1), [Format = "O"])})
}
in
Source
// The example displays the following output:
// 6/15/2024 1:45:30 PM +00:00 (Unspecified) --> 2024-06-15T13:45:30.0000000+00:00
// 6/15/2024 1:45:30 PM +00:00 (Utc) --> 2024-06-15T13:45:30.0000000+00:00
// 6/15/2024 1:45:30 PM +00:00 (Local) --> 2024-06-15T08:45:30.0000000-07:00
Σημείωμα
Η τιμή που επιστρέφεται από DateTimeZone.ToLocal εξαρτάται από το αν εκτελείτε το Power Query σε έναν τοπικό υπολογιστή ή σε σύνδεση. Για παράδειγμα, στο παραπάνω δείγμα σε ένα σύστημα στη ζώνη ώρας Ειρηνικού Η.Π.Α., το Power Query Desktop επιστρέφει -07:00
για την τοπική ώρα καθώς διαβάζει την ώρα που έχει οριστεί στον τοπικό υπολογιστή σας. Ωστόσο, το Power Query Online επιστρέφει +00:00
επειδή διαβάζει την ώρα που έχει οριστεί στις εικονικές μηχανές cloud, οι οποίες έχουν οριστεί σε UTC.
Το παρακάτω παράδειγμα χρησιμοποιεί το προσδιοριστικό μορφής "o" για να δημιουργήσει μια μορφοποιημένη συμβολοσειρά και, στη συνέχεια, επαναφέρει την αρχική τιμή ημερομηνίας και ώρας καλώντας μια ρουτίνα ανάλυσης ημερομηνίας και ώρας.
let
// Round-trip a local time
#"Origin Local Date" = DateTimeZone.ToLocal(
#datetimezone(2024, 4, 10, 6, 30, 0, 0, 0)
),
#"Local Date Text" = DateTimeZone.ToText(
#"Origin Local Date", [Format = "o"]
),
#"New Local Date" = DateTimeZone.FromText(#"Local Date Text"),
#"Local Round Trip" = Text.Format(
"Round-tripped #{0} Local to #{1} Local.",
{
DateTimeZone.ToText(#"Origin Local Date"),
DateTimeZone.ToText(#"New Local Date")
}
),
// Round-trip a UTC time
#"Origin UTC Date" = DateTimeZone.ToUtc(
#datetimezone(2024, 4, 12, 9, 30, 0, 0, 0)
),
#"UTC Date Text" = DateTimeZone.ToText(
#"Origin UTC Date", [Format = "o"]
),
#"New UTC Date" = DateTimeZone.FromText(#"UTC Date Text"),
#"UTC Round Trip" = Text.Format(
"Round-tripped #{0} UTC to #{1} UTC.",
{
DateTimeZone.ToText(#"Origin UTC Date"),
DateTimeZone.ToText(#"New UTC Date")
}
),
// Round-trip an 18 hour offset time
#"Origin Offset Date" = DateTimeZone.ToLocal(
#datetimezone(2024, 4, 10, 6, 30, 0, 0, 0) + #duration(0, 18, 0, 0)
),
#"Offset Date Text" = DateTimeZone.ToText(
#"Origin Offset Date", [Format = "o"]
),
#"New Offset Date" = DateTimeZone.FromText(#"Offset Date Text"),
#"Offset Round Trip" = Text.Format(
"Round-tripped #{0} to #{1}.",
{
DateTimeZone.ToText(#"Origin Offset Date"),
DateTimeZone.ToText(#"New Offset Date")
}
),
#"Round Trip Results" =
{#"Local Round Trip", #"UTC Round Trip", #"Offset Round Trip"}
in
#"Round Trip Results"
// The example displays the following output in Power Query Desktop:
// Round-tripped 4/9/2024 11:30:00 PM -07:00 Local to 4/9/2024 11:30:00 PM -07:00 Local.
// Round-tripped 4/12/2024 9:30:00 AM +00:00 UTC to 4/12/2024 9:30:00 AM +00:00 UTC.
// Round-tripped 4/10/2024 5:30:00 PM -07:00 to 4/10/2024 5:30:00 PM -07:00.
// The example displays the following output in Power Query Online:
// Round-tripped 4/10/2024 6:30:00 AM +00:00 Local to 4/10/2024 6:30:00 AM +00:00 Local.
// Round-tripped 4/12/2024 9:30:00 AM +00:00 UTC to 4/12/2024 9:30:00 AM +00:00 UTC.
// Round-tripped 4/11/2024 12:30:00 AM +00:00 to 4/11/2024 12:30:00 AM +00:00.
Το προσδιοριστικό μορφής RFC1123 ("R", "r")
Το προσδιοριστικό τυπικής μορφής "R" ή "r" αντιπροσωπεύει μια προσαρμοσμένη συμβολοσειρά μορφής ημερομηνίας και ώρας που δεν ορίζεται από μια συγκεκριμένη κουλτούρα. Είναι πάντα το ίδιο, ανεξάρτητα από την κουλτούρα που χρησιμοποιείται ή την υπηρεσία παροχής μορφής που παρέχεται. Η συμβολοσειρά προσαρμοσμένης μορφής είναι "ddd, dd MMM εεεε HH':'mm':'ss 'GMT'". Όταν χρησιμοποιείται αυτό το προσδιοριστικό τυπικής μορφής, η λειτουργία μορφοποίησης ή ανάλυσης χρησιμοποιεί πάντα την αμετάβλητη κουλτούρα.
Παρόλο που το πρότυπο RFC 1123 εκφράζει μια ώρα ως Συντονισμένη παγκόσμια ώρα (UTC), η λειτουργία μορφοποίησης δεν τροποποιεί την τιμή της ημερομηνίας και ώρας που μορφοποιείται. Επομένως, πρέπει να μετατρέψετε την τιμή ημερομηνίας/ώρας σε UTC καλώντας τη μέθοδο συνάρτησης DateTimeZone.ToUtc πριν εκτελέσετε τη λειτουργία μορφοποίησης.
Το παρακάτω παράδειγμα χρησιμοποιεί το προσδιοριστικό μορφής "r" για να εμφανίσει μια τιμή ώρας και ημερομηνίας σε ένα σύστημα στη ζώνη ώρας Ειρηνικού Η.Π.Α. (επτά ώρες πίσω από την ώρα UTC).
let
date1 = #datetimezone(2024, 4, 10, 6, 30, 0, -7, 0),
dateOffset = DateTimeZone.ToUtc(date1),
Source =
{
DateTimeZone.ToText(date1, [Format = "r"]),
// Displays Wed, 10 Apr 2024 13:30:00 GMT
DateTimeZone.ToText(dateOffset, [Format = "r"])
// Displays Wed, 10 Apr 2024 13:30:00 GMT
}
in
Source
Το προσδιοριστικό μορφής με δυνατότητα ταξινόμησης ("s")
Το προσδιοριστικό τυπικής μορφής "s" αντιπροσωπεύει μια προσαρμοσμένη συμβολοσειρά μορφής ημερομηνίας και ώρας που αντικατοπτρίζει ένα καθορισμένο πρότυπο (ISO 8601) και είναι μόνο για ανάγνωση. Επομένως, είναι πάντα η ίδια, ανεξάρτητα από την κουλτούρα που χρησιμοποιείται ή την υπηρεσία παροχής μορφής που παρέχεται. Η προσαρμοσμένη συμβολοσειρά μορφής είναι "yyyy'--MM'-'dd'T'HH':'mm''ss". Ο σκοπός του προσδιοριστή μορφής "s" είναι η παραγωγή συμβολοσειρών αποτελεσμάτων που ταξινομούν με συνέπεια σε αύξουσα ή φθίνουσα σειρά με βάση τις τιμές ημερομηνίας και ώρας.
Όταν χρησιμοποιείται αυτό το προσδιοριστικό τυπικής μορφής, η λειτουργία μορφοποίησης ή ανάλυσης χρησιμοποιεί πάντα την αμετάβλητη κουλτούρα.
Το παρακάτω παράδειγμα χρησιμοποιεί το προσδιοριστικό μορφής "s" για να εμφανίσει μια τιμή ημερομηνίας και ώρας σε ένα σύστημα στη ζώνη ώρας Ειρηνικού Η.Π.Α.
let
Source =
{
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "s", Culture = "en-US"])
// Displays 2024-04-10T06:30:00
}
in
Source
Το καθολικό προσδιοριστικό μορφής με δυνατότητα ταξινόμησης ("u")
Το προσδιοριστικό τυπικής μορφής "u" αντιπροσωπεύει μια προσαρμοσμένη συμβολοσειρά μορφής ημερομηνίας και ώρας που είναι πάντα η ίδια, ανεξάρτητα από την κουλτούρα που χρησιμοποιείται ή την υπηρεσία παροχής μορφής που παρέχεται. Η συμβολοσειρά προσαρμοσμένης μορφής είναι "yyyy'--MM'-'dd HH':'mm':'ss'Z'". Το μοτίβο απεικονίζει ένα καθορισμένο πρότυπο και η ιδιότητα είναι μόνο για ανάγνωση. Όταν χρησιμοποιείται αυτό το προσδιοριστικό τυπικής μορφής, η λειτουργία μορφοποίησης ή ανάλυσης χρησιμοποιεί πάντα την αμετάβλητη κουλτούρα.
Παρόλο που η συμβολοσειρά αποτελέσματος θα πρέπει να εκφράζει μια ώρα ως Συντονισμένη παγκόσμια ώρα (UTC), δεν εκτελείται μετατροπή της αρχικής τιμής ζώνης ημερομηνίας/ ώρας κατά τη διάρκεια της λειτουργίας μορφοποίησης. Επομένως, πρέπει να μετατρέψετε μια τιμή ζώνης ημερομηνίας/ώρας σε UTC καλώντας τη συνάρτηση DateTimeZone.ToUtc πριν τη μορφοποιήσετε.
Το παρακάτω παράδειγμα χρησιμοποιεί το προσδιοριστικό μορφής "u" για την εμφάνιση μιας τιμής ημερομηνίας και ώρας.
let
date1 = #datetimezone(2024, 4, 10, 6, 30, 0, -7, 0),
dateOffset = DateTimeZone.ToUtc(date1),
Source =
{
DateTimeZone.ToText(dateOffset, [Format = "u"]),
// Displays 2024-04-10 13:30:00Z
}
in
Source
Μορφές ώρας
Αυτή η ομάδα περιλαμβάνει τις ακόλουθες μορφές:
Το προσδιοριστικό μορφής σύντομου χρόνου ("t")
Το προσδιοριστικό τυπικής μορφής "t" αντιπροσωπεύει μια προσαρμοσμένη συμβολοσειρά μορφής ημερομηνίας και ώρας που ορίζεται από την καθορισμένη κουλτούρα. Για παράδειγμα, η συμβολοσειρά προσαρμοσμένης μορφής για την αμετάβλητη κουλτούρα είναι "HH:mm".
Η συμβολοσειρά αποτελέσματος επηρεάζεται από τις πληροφορίες μορφοποίησης μιας συγκεκριμένης κουλτούρας.
Το παρακάτω παράδειγμα χρησιμοποιεί το προσδιοριστικό μορφής "t" για την εμφάνιση μιας τιμής ημερομηνίας και ώρας.
let
Source =
{
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "t", Culture = ""]),
// Displays 06:30
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "t", Culture = "en-US"]),
// Displays 6:30 AM
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "t", Culture = "es-ES"])
// Displays 6:30
}
in
Source
Το προσδιοριστικό μορφής μεγάλης διάρκειας ("T")
Το προσδιοριστικό τυπικής μορφής "T" αντιπροσωπεύει μια προσαρμοσμένη συμβολοσειρά μορφής ημερομηνίας και ώρας που ορίζεται από τη συγκεκριμένη κουλτούρα. Για παράδειγμα, η συμβολοσειρά προσαρμοσμένης μορφής για την αμετάβλητη κουλτούρα είναι "HH:mm:ss".
Το παρακάτω παράδειγμα χρησιμοποιεί το προσδιοριστικό μορφής "T" για την εμφάνιση μιας τιμής ημερομηνίας και ώρας.
let
Source =
{
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "T", Culture = ""]),
// Displays 06:30:00
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "T", Culture = "en-US"]),
// Displays 6:30:00 AM
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "T", Culture = "es-ES"])
// Displays 6:30:00
}
in
Source
Μερικές μορφές ημερομηνίας
Αυτή η ομάδα περιλαμβάνει τις ακόλουθες μορφές:
Το προσδιοριστικό μορφής μήνα ("M", "m")
Το προσδιοριστικό τυπικής μορφής "M" ή "m" αντιπροσωπεύει μια προσαρμοσμένη συμβολοσειρά μορφής ημερομηνίας και ώρας που ορίζεται από τη συγκεκριμένη κουλτούρα. Για παράδειγμα, η συμβολοσειρά προσαρμοσμένης μορφής για την αμετάβλητη κουλτούρα είναι "MMMM dd".
Το παρακάτω παράδειγμα χρησιμοποιεί το προσδιοριστικό μορφής "m" για την εμφάνιση μιας τιμής ημερομηνίας και ώρας.
let
Source =
{
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "m", Culture = ""]),
// Displays April 10
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "m", Culture = "en-US"]),
// Displays April 10
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "m", Culture = "ms-MY"])
// Displays 10 April
}
in
Source
Το προσδιοριστικό μορφής του μήνα έτους ("Y", "y")
Το προσδιοριστικό τυπικής μορφής "Y" ή "y" αντιπροσωπεύει μια προσαρμοσμένη συμβολοσειρά μορφής ημερομηνίας που ορίζεται από μια συγκεκριμένη κουλτούρα. Για παράδειγμα, η συμβολοσειρά προσαρμοσμένης μορφής για την αμετάβλητη κουλτούρα είναι "εεεε ΜΜΜΜ".
Το παρακάτω παράδειγμα χρησιμοποιεί το προσδιοριστικό μορφής "y" για την εμφάνιση μιας τιμής ημερομηνίας και ώρας.
let
Source =
{
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "Y", Culture = ""]),
// Displays 2024 April
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "Y", Culture = "en-US"]),
// Displays April 2024
DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "y", Culture = "af-ZA"])
// Displays April 2024
}
in
Source