time.Time.AddDate() Function in Golang with Examples

In Go language, time packages supplies functionality for determining as well as viewing time. The Time.AddDate() function in Go language is used to check the time which is equivalent to adding the stated number of years, months, and days to the given “t”.
For example, if the parameters of the method are like (-2, 4, 5) and the stated t is February 3, 2018 then the output will be June 8, 2016. Like Date method here also if the range of months, days or years are outside the normal range then its automatically converted to normalized range. Moreover, this function is defined under the time package. Here, you need to import “time” package in order to use these functions.

Syntax:

func (t Time) AddDate(years int, months int, days int) Time

Here, “t” is the stated time.

Return Value: It returns the result of adding stated t to the stated number of years, months, and days.

Example 1:



filter_none

edit
close

play_arrow

link
brightness_4
code

// Golang program to illustrate the usage of
// Time.AddDate() function
  
// Including main package
package main
  
// Importing fmt and time
import "fmt"
import "time"
  
// Calling main
func main() {
  
    // Declaring Time in UTC
    Time := time.Date(2018, 6, 4, 0, 0, 0, 0, time.UTC)
  
    // Calling AddDate method with all
    // its parameters
    t1 := Time.AddDate(1, 2, 5)
    t2 := Time.AddDate(5, -2, 9)
    t3 := Time.AddDate(0, 3, -3)
    t4 := Time.AddDate(1, 0, 0)
  
    // Prints output
    fmt.Printf("%v\n", Time)
    fmt.Printf("%v\n", t1)
    fmt.Printf("%v\n", t2)
    fmt.Printf("%v\n", t3)
    fmt.Printf("%v\n", t4)
}

chevron_right


Output:

2018-06-04 00:00:00 +0000 UTC
2019-08-09 00:00:00 +0000 UTC
2023-04-13 00:00:00 +0000 UTC
2018-09-01 00:00:00 +0000 UTC
2019-06-04 00:00:00 +0000 UTC

Here, the output returned is in UTC as defined above.

Example 2:

filter_none

edit
close

play_arrow

link
brightness_4
code

// Golang program to illustrate the usage of
// Time.AddDate() function
  
// Including main package
package main
  
// Importing fmt and time
import "fmt"
import "time"
  
// Calling main
func main() {
  
    // Declaring Time in UTC
    Time := time.Date(2020, 15, 34, 0, 0, 0, 0, time.UTC)
  
    // Calling AddDate method with all
    // its parameters
    t1 := Time.AddDate(3, 13, 35)
    t2 := Time.AddDate(2, -24, 29)
    t3 := Time.AddDate(4, 32, -31)
    t4 := Time.AddDate(5, 10, -11)
  
    // Prints output
    fmt.Printf("%v\n", Time)
    fmt.Printf("%v\n", t1)
    fmt.Printf("%v\n", t2)
    fmt.Printf("%v\n", t3)
    fmt.Printf("%v\n", t4)
}

chevron_right


Output:

2021-04-03 00:00:00 +0000 UTC
2025-06-07 00:00:00 +0000 UTC
2021-05-02 00:00:00 +0000 UTC
2027-11-02 00:00:00 +0000 UTC
2027-01-23 00:00:00 +0000 UTC

Here, the range used is outside the usual range but they are normalized while converted.




My Personal Notes arrow_drop_up

Check out this Author's contributed articles.

If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.

Please Improve this article if you find anything incorrect by clicking on the "Improve Article" button below.


Article Tags :

Be the First to upvote.


Please write to us at contribute@geeksforgeeks.org to report any issue with the above content.