Επιστρέφει μια Μεταβλητή (Ακέραιος) που περιέχει το καθορισμένο τμήμα μιας δεδομένης ημερομηνίας.
Προειδοποίηση Υπάρχει πρόβλημα με τη χρήση αυτής της συνάρτησης. Η τελευταία Δευτέρα σε ορισμένα ημερολογιακά έτη μπορεί να επιστραφεί ως εβδομάδα 53, ενώ θα έπρεπε να είναι η εβδομάδα 1. Για περισσότερες πληροφορίες και μια λύση, ανατρέξτε στο θέμα Οι συναρτήσεις Format ή DatePart μπορούν να επιστρέψουν εσφαλμένο αριθμό εβδομάδας για την προηγούμενη Δευτέρα του έτους. |
Σύνταξη
DatePart ( διάστημα; ημερομηνία [, πρώτη_ημέρα_εβδομάδας] [, πρώτη_εβδομάδα_εβδομάδας] )
Η σύνταξη της συνάρτησης DatePart περιλαμβάνει τα παρακάτω ορίσματα:
Όρισμα |
Περιγραφή |
interval |
Υποχρεωτικό. Παράσταση συμβολοσειράς που είναι το χρονικό διάστημα που θέλετε να επιστραφεί. |
date |
Υποχρεωτικό. Μεταβλητή (Ημερομηνία) που θέλετε να αξιολογήσετε. |
πρώτη_ημέρα_εβδομάδας |
Προαιρετικό. Μια σταθερά που καθορίζει την πρώτη ημέρα της εβδομάδας. Εάν δεν καθοριστεί, πρώτη ημέρα θεωρείται η Κυριακή. |
πρώτη_εβδομάδα_έτους |
Προαιρετικό. Μια σταθερά που καθορίζει την πρώτη εβδομάδα του έτους. Εάν δεν καθοριστεί, πρώτη εβδομάδα θεωρείται η εβδομάδα η οποία περιλαμβάνει την 1η Ιανουαρίου. |
Ρυθμίσεις
Το όρισμα διαστήματος έχει τις εξής ρυθμίσεις:
Ρύθμιση |
Περιγραφή |
εεεε |
Έτος |
τ |
Τρίμηνο |
μ |
Μήνας |
y |
Ημέρα του έτους |
η |
Ημέρα |
β |
Weekday |
ββ |
Εβδομάδα |
ω |
Ώρα |
λ |
Λεπτό |
δ |
Δευτερόλεπτο |
Το όρισμα πρώτη_ημέρα_εβδομάδας έχει τις εξής ρυθμίσεις:
Σταθερά |
Τιμή |
Περιγραφή |
vbUseSystem |
0 |
Χρησιμοποιήστε τη ρύθμιση API NLS. |
vbSunday |
1 |
Κυριακή (προεπιλογή) |
vbMonday |
2 |
Δευτέρα |
vbTuesday |
3 |
Τρίτη |
vbWednesday |
4 |
Τετάρτη |
vbThursday |
5 |
Πέμπτη |
vbFriday |
6 |
Παρασκευή |
vbSaturday |
7 |
Σάββατο |
Το όρισμα πρώτη_εβδομάδα_εβδομάδας έχει τις εξής ρυθμίσεις:
Σταθερά |
Τιμή |
Περιγραφή |
vbUseSystem |
0 |
Χρησιμοποιήστε τη ρύθμιση API NLS. |
vbFirstJan1 |
1 |
Ξεκινήστε με την εβδομάδα κατά την οποία εμφανίζεται η 1η Ιανουαρίου (προεπιλογή). |
vbFirstFourDays |
2 |
Ξεκινήστε με την πρώτη εβδομάδα που έχει τουλάχιστον τέσσερις ημέρες στο νέο έτος. |
vbFirstFullWeek |
3 |
Ξεκινήστε με την πρώτη πλήρη εβδομάδα του έτους. |
Παρατηρήσεις
Μπορείτε να χρησιμοποιήσετε τη συνάρτηση DatePart για να υπολογίσετε μια ημερομηνία και να επιστρέψετε ένα συγκεκριμένο χρονικό διάστημα. Για παράδειγμα, μπορείτε να χρησιμοποιήσετε το DatePart για να υπολογίσετε την ημέρα της εβδομάδας ή την τρέχουσα ώρα.
Το όρισμα πρώτη_ημέρα_εβδομάδας επηρεάζει τους υπολογισμούς που χρησιμοποιούν τα σύμβολα διαστήματος "w" και "ww".
Εάν το date είναι λεκτική σταθερά ημερομηνίας, το καθορισμένο έτος γίνεται μόνιμο τμήμα αυτής της ημερομηνίας. Ωστόσο, εάν η ημερομηνία περικλείεται σε διπλά εισαγωγικά (" ") και παραλείψετε το έτος, το τρέχον έτος εισάγεται στον κώδικά σας κάθε φορά που υπολογίζεται η παράσταση ημερομηνίας . Έτσι μπορείτε να γράψετε κώδικα που μπορεί να χρησιμοποιηθεί σε διαφορετικά έτη.
Σημείωση: Για την ημερομηνία, εάν η ρύθμιση της ιδιότητας Ημερολόγιο είναι Γρηγοριανή, η ημερομηνία που παρέχεται πρέπει να είναι Γρηγοριανή. Εάν το ημερολόγιο είναι Χίζρι, η ημερομηνία που παρέχεται πρέπει να είναι Χίζρι.
Το τμήμα ημερομηνίας που επιστρέφεται είναι στις μονάδες χρονικής περιόδου του τρέχοντος αραβικού ημερολογίου. Για παράδειγμα, εάν το τρέχον ημερολόγιο είναι Χίζρι και η ημερομηνία που επιστρέφεται είναι το έτος, η τιμή του έτους είναι ένα έτος Χίζρι.
Παραδείγματα ερωτημάτων
Expression |
Αποτελέσματα |
SELECT DatePart("yyyy";[DateofSale]) AS NewDate FROM ProductSales; |
Επιστρέφει το "Έτος" των τιμών ημερομηνίας του πεδίου "DateofSale". |
SELECT DatePart("τ";[DateofSale]) AS NewDate FROM ProductSales; |
Επιστρέφει το "Τρίμηνο" (με βάση το έτος calender) των τιμών ημερομηνίας του πεδίου "DateofSale". |
SELECT DatePart("y";[DateofSale]) AS NewDate FROM ProductSales; |
Επιστρέφει την "Ημέρα του έτους" (1 έως 365) των τιμών ημερομηνίας του πεδίου "DateofSale". |
SELECT DatePart("η";[DateofSale]) AS Νέα ημερομηνία ΑΠΟ Πωλήσεις προϊόντων; |
Επιστρέφει την "Ημέρα" των τιμών ημερομηνίας του πεδίου "DateofSale". |
SELECT DatePart("w";[DateofSale]) AS NewDate FROM ProductSales; |
Επιστρέφει την "Ημέρα της εβδομάδας" (από το 1 έως το 7, όπου το 1 αντιπροσωπεύει την Κυριακή) των τιμών ημερομηνίας του πεδίου "DateofSale". |
SELECT DatePart("εε";[DateofSale]) AS NewDate FROM Πωλήσεις προϊόντων; |
Επιστρέφει τον "Αριθμό εβδομάδας" (από 1 έως 52) των τιμών ημερομηνίας του πεδίου "DateofSale". |
SELECT DatePart("η";[DateTime]) AS NewDate FROM ProductSales; |
Επιστρέφει την "Ώρα" των τιμών ημερομηνίας του πεδίου "DateTime". |
SELECT DatePart("n";[DateTime]) AS NewDate FROM ProductSales; |
Επιστρέφει τα "Λεπτά" των τιμών ημερομηνίας του πεδίου "DateTime". |
SELECT DatePart("s";[DateTime]) AS NewDate FROM ProductSales; |
Επιστρέφει τα "δευτερόλεπτα" των τιμών ημερομηνίας του πεδίου "DateTime". |
Παράδειγμα VBA
Σημείωση: Παραδείγματα που ακολουθούν δείχνουν τη χρήση αυτής της συνάρτησης σε μια λειτουργική μονάδα Visual Basic for Applications (VBA). Για περισσότερες πληροφορίες σχετικά με την εργασία με τη VBA, επιλέξτε Αναφορά προγραμματιστών στην αναπτυσσόμενη λίστα δίπλα στην Αναζήτηση και πληκτρολογήστε έναν ή περισσότερους όρους στο πλαίσιο αναζήτησης.
Αυτό το παράδειγμα λαμβάνει μια ημερομηνία και, χρησιμοποιώντας τη συνάρτηση DatePart , εμφανίζει το τρίμηνο του έτους στο οποίο εμφανίζεται.
Dim TheDate As Date ' Declare variables.
Dim Msg TheDate = InputBox("Enter a date:") Msg = "Quarter: " & DatePart("q", TheDate) MsgBox Msg