com.microej.wear.services

Interface TimeService

public interface TimeService

This service allows Features to get time information.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	TimeService.ConfigurationListener The listener interface for receiving notifications when the time configuration of the device has changed (date, time, time zone).

Method Summary

Modifier and Type	Method and Description
void	addConfigurationListener(TimeService.ConfigurationListener listener) Adds the given TimeService.ConfigurationListener to the list of listeners that are notified when the time configuration of the device has changed.
long	getCurrentTime() Returns the current time.
String	getTimeZoneId() Returns the current time zone ID.
int	getTimeZoneOffset() Returns the current offset from UTC in seconds.
void	removeConfigurationListener(TimeService.ConfigurationListener listener) Removes the given TimeService.ConfigurationListener to the list of listeners that are notified when the time configuration of the device has changed.
void	setTimeConfiguration(long currentTime, String zoneId, int zoneOffset) Sets the time configuration to use.

Method Detail

addConfigurationListener

void addConfigurationListener(TimeService.ConfigurationListener listener)

Adds the given TimeService.ConfigurationListener to the list of listeners that are notified when the time configuration of the device has changed.

Parameters:

listener - the new listener to add

getCurrentTime

long getCurrentTime()

Returns the current time.

Returns:

the current time (in milliseconds, measured from the Java Epoch)

getTimeZoneId

String getTimeZoneId()

Returns the current time zone ID.

The zone ID is a string that represents either a region-based time zone or a fixed offset from UTC.

Returns:

the current time zone ID

getTimeZoneOffset

int getTimeZoneOffset()

Returns the current offset from UTC in seconds.

The offset reflects the time zone and daylight saving time, applicable at the current instant.

Returns:

the current offset from UTC in seconds

removeConfigurationListener

void removeConfigurationListener(TimeService.ConfigurationListener listener)

Removes the given TimeService.ConfigurationListener to the list of listeners that are notified when the time configuration of the device has changed.

Does nothing if the listener is not registered.

Parameters:

listener - the listener to be removed

setTimeConfiguration

void setTimeConfiguration(long currentTime,
                          String zoneId,
                          int zoneOffset)

Sets the time configuration to use.

Parameters:

currentTime - the new time (in milliseconds, measured from the Java Epoch)

zoneId - the new time zone ID

zoneOffset - the new offset from UTC