Επιστρέφει μια Μεταβλητή (Ημερομηνία) που περιέχει μια ημερομηνία στην οποία έχει προστεθεί ένα καθορισμένο χρονικό διάστημα.
Σύνταξη
DateAdd ( διάστημα; αριθμός; ημερομηνία )
Η σύνταξη της συνάρτησης DateAdd περιλαμβάνει τα παρακάτω ορίσματα:
|
Όρισμα |
Περιγραφή |
|---|---|
|
interval |
Υποχρεωτικό. Παράσταση συμβολοσειράς που είναι το χρονικό διάστημα που θέλετε να προσθέσετε. |
|
αριθμός |
Υποχρεωτικό. Αριθμητική παράσταση που είναι ο αριθμός των χρονικών διαστημάτων που θέλετε να προσθέσετε. Μπορεί να είναι θετικός (για τις μελλοντικές ημερομηνίες) ή αρνητικός (για ημερομηνίες στο παρελθόν). |
|
ημερομηνία |
Υποχρεωτικό. Μεταβλητή (Ημερομηνία) ή λεκτική σταθερά που αντιπροσωπεύει την ημερομηνία στην οποία προστίθεται το χρονικό διάστημα. |
Ρυθμίσεις
Το χρονικό διάστημαόρισμα έχει τις εξής ρυθμίσεις:
|
Ρύθμιση |
Περιγραφή |
|---|---|
|
εεεε |
Έτος |
|
τ |
Τρίμηνο |
|
μ |
Μήνας |
|
y |
Ημέρα του έτους |
|
η |
Ημέρα |
|
β |
Weekday |
|
ββ |
Εβδομάδα |
|
ω |
Ώρα |
|
λ |
Λεπτό |
|
δ |
Δευτερόλεπτο |
Παρατηρήσεις
Μπορείτε να χρησιμοποιήσετε τη συνάρτηση DateAdd για να προσθέσετε ή να αφαιρέσετε ένα καθορισμένο χρονικό διάστημα από μια ημερομηνία. Για παράδειγμα, μπορείτε να χρησιμοποιήσετε τη συνάρτηση DateAdd για να υπολογίσετε μια ημερομηνία 30 ημέρες από σήμερα ή μια ώρα σε 45 λεπτά από τώρα.
Για να προσθέσετε ημέρες στην ημερομηνία, μπορείτε να χρησιμοποιήσετε την Ημέρα του έτους ("y"), την Ημέρα ("δ") ή την Ημέρα της Εβδομάδας ("w").
Η συνάρτηση DateAdd δεν θα επιστρέψει μη έγκυρη ημερομηνία. Το παρακάτω παράδειγμα προσθέτει ένα μήνα στις 31 Ιανουαρίου:
DateAdd("m", 1, "31-Jan-95")
Σε αυτή την περίπτωση, η συνάρτηση DateAdd επιστρέφει 28-Φεβ-95, όχι 31-Φεβ-95. Εάν η ημερομηνία είναι 31-Ιαν-96, επιστρέφει 29-Φεβ-96 επειδή το 1996 είναι δίσεκτο έτος.
Εάν η υπολογιζόμενη ημερομηνία προηγείται του έτους 100 (δηλαδή, αφαιρείτε περισσότερα έτη από όσα βρίσκονται στην ημερομηνία), προκύπτει σφάλμα.
Εάν το όρισμα αριθμός δεν είναι μεγάλη τιμή, στρογγυλοποιείται στον πλησιέστερο ακέραιο αριθμό πριν από την αξιολόγηση.
Σημείωση: Η μορφή της επιστρεφόμενης τιμής για το DateAdd καθορίζεται από τις ρυθμίσεις του Πίνακα Ελέγχου και όχι από τη μορφή που μεταβιβάζεται στο όρισμα ημερομηνία .
Σημείωση: Για την ημερομηνία, εάν η ρύθμιση της ιδιότητας Ημερολόγιο είναι Γρηγοριανή, η ημερομηνία που παρέχεται πρέπει να είναι Γρηγοριανή. Εάν το ημερολόγιο είναι Χίζρι, η ημερομηνία που παρέχεται πρέπει να είναι Χίζρι. Εάν οι τιμές μήνα είναι ονόματα, το όνομα πρέπει να είναι συνεπές με την τρέχουσα ρύθμιση της ιδιότητας Ημερολόγιο . Για να ελαχιστοποιήσετε την πιθανότητα ονομάτων μηνών σε διένεξη με την τρέχουσα ρύθμιση της ιδιότητας Ημερολόγιο , εισαγάγετε αριθμητικές τιμές μήνα (μορφή σύντομης ημερομηνίας).
Παραδείγματα ερωτημάτων
|
Expression |
Αποτελέσματα |
|---|---|
|
SELECT DateAdd("YYYY";1;[DateofSale]) AS Παράσταση1 FROM Πωλήσεις Προϊόντων; |
Επιστρέφει τα αποτελέσματα προσθέτοντας 1 έτος στις τιμές ημερομηνίας του πεδίου "DateofSale". |
|
SELECT DateAdd("YYYY";-1;[DateofSale]) AS Παράσταση1 FROM Πωλήσεις Προϊόντων; |
Επιστρέφει τα αποτελέσματα αφαιρώντας 1 έτος στις τιμές ημερομηνίας του πεδίου "DateofSale". |
|
SELECT DateAdd("η";10;[DateofSale]) AS NewDate FROM ProductSales; |
Επιστρέφει τα αποτελέσματα στη στήλη "NewDate" προσθέτοντας 10 ημέρες στις τιμές ημερομηνίας του πεδίου "DateofSale". |
|
SELECT DateAdd("ww";-1;[DateofSale]) AS NewDate FROM ProductSales; |
Επιστρέφει τα αποτελέσματα στη στήλη "NewDate" αφαιρώντας 1 εβδομάδα (7 ημέρες) από τις τιμές ημερομηνίας του πεδίου "DateofSale". |
Παράδειγμα VBA
Σημείωση: Παραδείγματα που ακολουθούν δείχνουν τη χρήση αυτής της συνάρτησης σε μια λειτουργική μονάδα Visual Basic for Applications (VBA). Για περισσότερες πληροφορίες σχετικά με την εργασία με τη VBA, ανατρέξτε στο θέμα Αναφορά VBA για Access.
Αυτό το παράδειγμα λαμβάνει μια ημερομηνία ως εισαγωγή και χρησιμοποιεί τη συνάρτηση DateAdd για να εμφανίσει μια αντίστοιχη ημερομηνία έναν καθορισμένο αριθμό μηνών στο μέλλον.
Dim FirstDate As Date ' Declare variables.
Dim IntervalType As String
Dim Number As Integer
Dim Msg
IntervalType = "m" ' "m" specifies months as interval.
FirstDate = InputBox("Enter a date")
Number = InputBox("Enter number of months to add")
Msg = "New date: " & _
DateAdd(IntervalType, Number, FirstDate)
MsgBox Msg
