Net::Time(3pm) Perl Programmers Reference Guide Net::Time(3pm)

# [NAME](#NAME)

Net::Time - time and daytime network client interface

# [SYNOPSIS](#SYNOPSIS)

```
    use Net::Time qw(inet_time inet_daytime);
    print inet_time();          # use default host from Net::Config
    print inet_time('localhost');
    print inet_time('localhost', 'tcp');
    print inet_daytime();       # use default host from Net::Config
    print inet_daytime('localhost');
    print inet_daytime('localhost', 'tcp');
```

# [DESCRIPTION](#DESCRIPTION)

"Net::Time" provides subroutines that obtain the time on a remote machine.

## [Functions](#Functions)

"inet\_time(\[$host\[, $protocol\[, $timeout]]])"

Obtain the time on $host, or some default host if $host is not given or not defined, using the protocol as defined in RFC868. The optional argument $protocol should define the protocol to use, either "tcp" or "udp". The result will be a time value in the same units as returned by **time()** or *undef* upon failure.

"inet\_daytime(\[$host\[, $protocol\[, $timeout]]])"

Obtain the time on $host, or some default host if $host is not given or not defined, using the protocol as defined in RFC867. The optional argument $protocol should define the protocol to use, either "tcp" or "udp". The result will be an ASCII string or *undef* upon failure.

# [EXPORTS](#EXPORTS)

The following symbols are, or can be, exported by this module:

[Default Exports](#Default)

*None*.

[Optional Exports](#Optional)

"inet\_time", "inet\_daytime".

[Export Tags](#Export)

*None*.

# [KNOWN BUGS](#KNOWN_BUGS)

*None*.

# [AUTHOR](#AUTHOR)

Graham Barr <gbarr@pobox.com <mailto:gbarr@pobox.com>>.

Steve Hay <shay@cpan.org <mailto:shay@cpan.org>> is now maintaining libnet as of version 1.22\_02.

# [COPYRIGHT](#COPYRIGHT)

Copyright (C) 1995-2004 Graham Barr. All rights reserved.

Copyright (C) 2014, 2020 Steve Hay. All rights reserved.

# [LICENCE](#LICENCE)

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself, i.e. under the terms of either the GNU General Public License or the Artistic License, as specified in the *LICENCE* file.

# [VERSION](#VERSION)

Version 3.15

# [DATE](#DATE)

20 March 2023

# [HISTORY](#HISTORY)

See the *Changes* file.

2026-08-31 perl v5.44.0

---

Document: Net::Time(3pm) from perl 5.44.0-r1 (Chainguard OS)
Source: https://github.com/Perl/perl5.git