Java 8 Clock offset() method with Examples
Last Updated :
10 Dec, 2018
Java Clock class is part of Date Time API, java.time.Clock, of Java. The Java Date Time API was added from Java version 8.
The offset() method is a static method of Clock class which returns a clock with instant equal to the sum of the instants of clock passed as parameter and specific Offset duration. If the duration added is positive, then the returned clock represents the instant of the clock later by the specified duration from base clock. If the duration added is negative, then the returned clock is earlier than the date and time of the base clock. A duration of Zero does nothing to the base clock and returns the base clock.
If the base clock is immutable, thread-safe and Serializable then returned clock is also immutable, thread-safe and Serializable.
Syntax:
public static Clock offset(Clock baseClock, Duration offsetDuration)
Parameters: This method accepts two mandatory parameters:
- baseclock – a clock for adding duration. It cannot be a null value.
- offsetDuration – duration to add with baseClock. It cannot be a null value as well.
Return Value: This method returns a clock with instant equal to the sum of instants of clock passed as parameter and Specific Offset duration.
Below programs illustrates offset(Clock baseClock, Duration offsetDuration) method of java.time.Clock class:
Program 1: When offset is passed as hours.
import java.time.*;
public class offsetMethodDemo {
public static void main(String[] args)
{
Clock realClock = Clock.systemDefaultZone();
System.out.println( "Real clock instant is "
+ realClock.instant());
Clock clock = Clock.offset(realClock, Duration.ZERO);
System.out.println( "New clock instant"
+ " with Duration = 0 is "
+ clock.instant());
clock = Clock.offset(realClock, Duration.ofHours( 24 ));
System.out.println( "New clock instant"
+ " with Duration = 24hours is "
+ clock.instant());
clock = Clock.offset(realClock, Duration.ofHours(- 24 ));
System.out.println( "New clock instant"
+ " with Duration = -24hours is "
+ clock.instant());
}
}
|
Output:
Real clock instant is 2018-08-21T09:43:13.519Z
New clock instant with Duration = 0 is 2018-08-21T09:43:13.785Z
New clock instant with Duration = 24hours is 2018-08-22T09:43:13.785Z
New clock instant with Duration = -24hours is 2018-08-20T09:43:13.785Z
Program 2: When offset is passed as seconds and minutes.
import java.time.*;
public class offsetMethodDemo {
public static void main(String[] args)
{
ZoneId zoneId = ZoneId.of( "Europe/Paris" );
Clock realClock = Clock.system(zoneId);
System.out.println( "Real clock instant is "
+ realClock.instant());
Clock clock = Clock.offset(realClock, Duration.ofSeconds( 50 ));
System.out.println( "Time after 50 second later"
+ " than real Clock is " + clock.instant());
clock = Clock.offset(realClock, Duration.ofMinutes( 30 ));
System.out.println( "Time after 30 minutes later"
+ " than real Clock is " + clock.instant());
}
}
|
Output:
Real clock instant is 2018-08-21T09:43:18.921Z
Time after 50 second later than real Clock is 2018-08-21T09:44:08.969Z
Time after 30 minutes later than real Clock is 2018-08-21T10:13:18.969Z
Reference: https://docs.oracle.com/javase/8/docs/api/java/time/Clock.html#offset-java.time.Clock-java.time.Duration-
Share your thoughts in the comments
Please Login to comment...