org.apache.commons.net.time
Class TimeUDPClient
DatagramSocketClient
org.apache.commons.net.time.TimeUDPClient
public final class TimeUDPClient
extends DatagramSocketClient
The TimeUDPClient class is a UDP implementation of a client for the
Time protocol described in RFC 868. To use the class, merely
open a local datagram socket with
open
and call
getTime
or
getDate
to retrieve the time. Then call
close
to close the connection properly. Unlike
TimeTCPClient
,
successive calls to
getTime
or
getDate
are permitted
without re-establishing a connection. That is because UDP is a
connectionless protocol and the Time protocol is stateless.
Date | getDate(InetAddress host) - Same as
getTime(host, DEFAULT_PORT); **
|
Date | getDate(InetAddress host, int port) -
Retrieves the time from the server and returns a Java Date
containing the time converted to the local timezone.
|
long | getTime(InetAddress host) - Same as
getTime(host, DEFAULT_PORT); **
|
long | getTime(InetAddress host, int port) -
Retrieves the time from the specified server and port and
returns it.
|
DEFAULT_PORT
public static final int DEFAULT_PORT
The default time port. It is set to 37 according to RFC 868. **
SECONDS_1900_TO_1970
public static final long SECONDS_1900_TO_1970
The number of seconds between 00:00 1 January 1900 and
00:00 1 January 1970. This value can be useful for converting
time values to other formats.
getDate
public Date getDate(InetAddress host)
throws IOException
Same as getTime(host, DEFAULT_PORT);
**
getDate
public Date getDate(InetAddress host,
int port)
throws IOException
Retrieves the time from the server and returns a Java Date
containing the time converted to the local timezone.
host
- The address of the server.port
- The port of the service.
- A Date value containing the time retrieved from the server
converted to the local timezone.
getTime
public long getTime(InetAddress host)
throws IOException
Same as getTime(host, DEFAULT_PORT);
**
getTime
public long getTime(InetAddress host,
int port)
throws IOException
Retrieves the time from the specified server and port and
returns it. The time is the number of seconds since
00:00 (midnight) 1 January 1900 GMT, as specified by RFC 868.
This method reads the raw 32-bit big-endian
unsigned integer from the server, converts it to a Java long, and
returns the value.
host
- The address of the server.port
- The port of the service.
- The time value retrieved from the server.