# Net::Time - man - phpman

## NAME
    [Net::Time](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3ATime/markdown) - time and daytime network client interface

## SYNOPSIS
        use [Net::Time](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3ATime/markdown) qw(inet_time inet_daytime);

        print inet_time();          # use default host from [Net::Config](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3AConfig/markdown)
        print inet_time('localhost');
        print inet_time('localhost', 'tcp');

        print inet_daytime();       # use default host from [Net::Config](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3AConfig/markdown)
        print inet_daytime('localhost');
        print inet_daytime('localhost', 'tcp');

## DESCRIPTION
    "[Net::Time](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3ATime/markdown)" provides subroutines that obtain the time on a remote machine.

### 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
    The following symbols are, or can be, exported by this module:

    Default Exports
        *None*.

    Optional Exports
        "inet_time", "inet_daytime".

    Export Tags
        *None*.

## KNOWN BUGS
    *None*.

## 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 (C) 1995-2004 Graham Barr. All rights reserved.

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

## 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 3.13

## DATE
    23 Dec 2020

## HISTORY
    See the Changes file.