Skip to main content

DateTimeZone.From

Δημιουργεί μια datetimezone από την τιμή που δόθηκε.

Syntax

DateTimeZone.From(
value as any,
optional culture as text
) as datetimezone

Remarks

Δημιουργεί ένα datetimezone από τη δεδομένη τιμή.

  • value: Η τιμή που χρησιμοποιείται για τη δημιουργία ενός datetimezone.
  • culture: (Προαιρετικό) Η κουλτούρα που θα χρησιμοποιηθεί κατά τον μετασχηματισμό της τιμής (για παράδειγμα, "en-US").

Οι τιμές των ακόλουθων τύπων μπορούν να μετατραπούν σε τιμή datetimezone:

  • text: Επιστρέφει μια τιμή datetimezone από αναπαράσταση κειμένου. Ανατρέξτε στο DateTimeZone.FromText για λεπτομέρειες.
  • date: Επιστρέφει ένα datetimezone με value ως στοιχείο ημερομηνίας, 12:00:00 π.μ ως στοιχείο ώρας και την απόκλιση που αντιστοιχεί στην τοπική ζώνη ώρας.
  • datetime: Επιστρέφει ένα datetimezone με value ως ημερομηνία/ώρα και τη μετατόπιση που αντιστοιχεί στην τοπική ζώνη ώρας.
  • datetimezone: Επιστρέφει value.
  • time: Επιστρέφει ένα datetimezone με το ισοδύναμο ημερομηνίας της ημερομηνίας αυτοματισμού OLE του 0 ως στοιχείο ημερομηνίας, value ως στοιχείο ώρας και τη μετατόπιση που αντιστοιχεί στην τοπική ζώνη ώρας. Η Ημερομηνία αυτοματισμού OLE αποτελείται από έναν αριθμό κινητής υποδιαστολής, του οποίου το ακέραιο στοιχείο είναι ο αριθμός των ημερών πριν ή μετά τα μεσάνυχτα, 30 Δεκεμβρίου 1899, και του οποίου το κλασματικό στοιχείο αντιπροσωπεύει την ώρα εκείνης της ημέρας διαιρούμενη με 24. Για παράδειγμα, τα μεσάνυχτα, 31 Δεκεμβρίου 1899 αντιπροσωπεύονται από το 1,0, 6 π.μ. 1 Ιανουαρίου 1900 αντιπροσωπεύονται από το 2,25, τα μεσάνυχτα. 29 Δεκεμβρίου 1899 αντιπροσωπεύονται από το -1,0 και 6 π.μ. 29 Δεκεμβρίου 1899 αντιπροσωπεύονται από το -1,25. Η βασική τιμή είναι τα μεσάνυχτα, 30 Δεκεμβρίου 1899. Η ελάχιστη τιμή είναι τα μεσάνυχτα, 1 Ιανουαρίου 0100. Η μέγιστη τιμή είναι η τελευταία στιγμή της 31ης Δεκεμβρίου 9999.
  • αριθμός: Επιστρέφει ένα datetimezone με το ισοδύναμο ημερομηνίας/ώρας της ημερομηνίας αυτοματισμού OLE που εκφράζεται κατά value και τη μετατόπιση που αντιστοιχεί στην τοπική ζώνη ώρας.
  • null: Επιστρέφει null.

Αν value είναι οποιουδήποτε άλλου τύπου, επιστρέφεται σφάλμα.

Η τιμή της μετατόπισης που αντιστοιχεί στην τοπική ζώνη ώρας είναι διαφορετική κατά την εκτέλεση αυτής της συνάρτησης τοπικά, σε αντίθεση με την εκτέλεση της online. Όταν εκτελείται τοπικά, επιστρέφεται η τοπική ζώνη ώρας. Όταν εκτελείται online, επιστρέφεται η ζώνη ώρας UTC (+00:00).

Examples

Example #1

Μετατρέψτε την αναπαράσταση κειμένου μιας ημερομηνίας, ώρας και ζώνης ώρας σε datetimezone τιμή.

DateTimeZone.From("2020-10-30T01:30:00-08:00")

Result:

#datetimezone(2020, 10, 30, 01, 30, 00, -8, 00)

Example #2

Μετατρέψτε την αναπαράσταση κειμένου της ημερομηνίας, της ώρας και της ζώνης ώρας της βραζιλιάνικης πορτογαλικής γλώσσας σε μια τιμή datetimezone.

DateTimeZone.From("13 de agosto de 2025 15:43:00 -03:00", "pt-BR")

Result:

#datetimezone(2025, 08, 13, 15, 43, 00, -3, 00)

Example #3

Μετατρέψτε έναν αριθμό που αντιπροσωπεύει την 1η Ιανουαρίου 2025 στις 12 μ.μ. σε τιμή datetimezone. Η ζώνη ώρας στο αποτέλεσμα εξαρτάται από το αν το παράδειγμα εκτελείται τοπικά ή online.

DateTimeZone.From(45658.5)

Result:

#datetimezone(2025, 01, 01, 12, 00, 00, 0, 00)

Category

DateTimeZone