com.azul.zing.management

Interface TimeMXBean

public interface TimeMXBean

Time provides the elapsed time since the launch of the Zing virtual machine and the clock time in milliseconds at the launch of the Zing virtual machine. The millisecond value returned from getJVMStartTimeMillis is convertible using java.util.Date to the wall clock time when the Zing virtual machine was started.

ObjectName: com.azul.zing:type=Time

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	convertElapsedTimeSinceJVMStartSecToDateTimeString(double timeSec) Returns a Date-Time String representing the date and time of the elapsed time since the JVM start in seconds.
double	getElapsedTimeSinceJVMStartSec() Returns elapsed time since the launch of the Zing virtual machine.
java.lang.String	getUnixTimeOfJVMStartAsDateTimeString() Returns a Date-Time String representing the Unix (or Epoch or Posix) time in milliseconds when the Zing virtual machine was started represented as the number of milliseconds between midnight, January 1, 1970 UTC and the start of the Zing virtual machine.
long	getUnixTimeOfJVMStartMillis() Returns the Unix (or Epoch or Posix) time in milliseconds when the Zing virtual machine was started represented as the number of milliseconds between the start of the Zing virtual machine and midnight, January 1, 1970 UTC.
java.lang.String	getVersion() Version of the TimeMXBean application programming interface.
boolean	setFormatForDateTimeString(java.lang.String formatString) Sets the format for the formatted date string returned from getUnixTimeOfJVMStartAsString() and convertElapsedTimeSinceJVMStartSecToDateTimeString(double timeSec).
boolean	setFormatForDateTimeStringToDefaultValue() Sets to the default value the format for the formatted date string returned from getUnixTimeOfJVMStartAsString() and convertElapsedTimeSinceJVMStartSecToDateTimeString(double timeSec).

Method Detail

convertElapsedTimeSinceJVMStartSecToDateTimeString

java.lang.String convertElapsedTimeSinceJVMStartSecToDateTimeString(double timeSec)

Returns a Date-Time String representing the date and time of the elapsed time since the JVM start in seconds.

Parameters:

timeSec - the time, most frequently returned in a query or from getElapsedTimeSinceJVMStartSec().

Returns:

Date-Time String that represents the date and time of the timeSec parameter. The format String used to format the date and time, by default is:

         "EEE MMM dd HH:mm:ss.SSS zzz yyyy"
 

which, as an example, will print:

          Wed Aug 06 14:10:54.105 PDT 2014
 

Use setFormatForDateTimeString(String formatString) to override the default Date-Time format.

getElapsedTimeSinceJVMStartSec

double getElapsedTimeSinceJVMStartSec()

Returns elapsed time since the launch of the Zing virtual machine.

Returns:

elapsed time since the launch of the Zing virtual machine in units of seconds.

getUnixTimeOfJVMStartAsDateTimeString

java.lang.String getUnixTimeOfJVMStartAsDateTimeString()

Returns a Date-Time String representing the Unix (or Epoch or Posix) time in milliseconds when the Zing virtual machine was started represented as the number of milliseconds between midnight, January 1, 1970 UTC and the start of the Zing virtual machine.

Returns:

Date-Time String that represents the Unix time in units of milliseconds when the Zing virtual machine was launched using the default format:

         "EEE MMM dd HH:mm:ss.SSS zzz yyyy" which, as an example, will print:
          Wed Aug 06 14:10:54.105 PDT 2014
         

Use setFormatForDateTimeString(String formatString) to override the default Date-Time format.

getUnixTimeOfJVMStartMillis

long getUnixTimeOfJVMStartMillis()

Returns the Unix (or Epoch or Posix) time in milliseconds when the Zing virtual machine was started represented as the number of milliseconds between the start of the Zing virtual machine and midnight, January 1, 1970 UTC. You can convert the millisecond value returned to a date and wall clock time using java.util.Date. Or, you can call getUnixTimeOfJVMStartAsDateTimeString() to return a formatted Date-Time String.

Returns:

Unix time in units of milliseconds when the Zing virtual machine was launched.

getVersion

java.lang.String getVersion()

Version of the TimeMXBean application programming interface. The format for the version is majorVersion.minorVersion.microVersion.

Returns:

version of the TimeMXBean application programming interface.

setFormatForDateTimeString

boolean setFormatForDateTimeString(java.lang.String formatString)

Sets the format for the formatted date string returned from getUnixTimeOfJVMStartAsString() and convertElapsedTimeSinceJVMStartSecToDateTimeString(double timeSec). See the Javadoc for java.text.SimpleDateFormat for a description about how to use date and time pattern strings to specify a date and time format. The default for the format string is:

     "EEE MMM dd HH:mm:ss.SSS zzz yyyy"
 

which, for example will print:

      Wed Aug 06 14:10:54.105 PDT 2014
 

Parameters:

formatString - that represents the format to be used for formatting the conversion of any millisecond value representing the Unix (or Epoch or Posix) time.

Returns:

true if successful, else false. Reasons for failure include bad format or missing value.

Throws:

java.lang.SecurityException - if caller does not have ManagementPermission("control").

setFormatForDateTimeStringToDefaultValue

boolean setFormatForDateTimeStringToDefaultValue()

Sets to the default value the format for the formatted date string returned from getUnixTimeOfJVMStartAsString() and convertElapsedTimeSinceJVMStartSecToDateTimeString(double timeSec). The default value for the format string is:

     "EEE MMM dd HH:mm:ss.SSS zzz yyyy"
 

which, for example will print:

      Wed Aug 06 14:10:54.105 PDT 2014
 

Returns:

true if successful, else false.

Throws:

java.lang.SecurityException - if caller does not have ManagementPermission("control").