time.Until() Function in Golang With Examples

In Go language, time packages supplies functionality for determining as well as viewing time. The Until() function in Go language holds time value t and is used to evaluate the duration until the time t. Moreover, this function is defined under the time package. Here, you need to import the “time” package in order to use these functions.

Syntax:

func Until(t Time) Duration

Here, t is the time value.

Note: This method is shortcut for t.Sub(time.Now()).

Return value: It returns the duration until t.

Example 1:

// Golang program to illustrate the usage of
// Until() function

// Including main package
package main

// Importing fmt and time
import (
    "fmt"
    "time"
)

// Calling main
func main() {

    // Defining time value
    // of Until method
    t := time.Now()

    // Prints duration until t
    fmt.Println("Duration until t:", time.Until(t))
}

Output:

Duration until t: -230ns  // Can be different at different run times

Here, duration until t is printed. So, it can be different at different run times.

Example 2:

// Golang program to illustrate the usage of
// Until() function

// Including main package
package main

// Importing fmt and time
import (
    "fmt"
    "time"
)

// Calling main
func main() {

    // Defining time value
    // of Until method
    t := time.Now()

    // Calling Until method with its
    // parameter
    Duration := time.Until(t)

    // Prints duration until
    // t in nanoseconds
    fmt.Println("duration until t in nanoseconds: ",
                           Duration.Nanoseconds())
}

Output:

duration until t in nanoseconds:  -340  // Can be different at different run times