# NAME

# NAME

MojoX::Date::Local - Mojo::Date, but in my timezone and with custom formats

# SYNOPSIS

use MojoX::Date::Local;

my $now = MojoX::Date::Local->new;
say $now->to_datetime; # => 2020-05-27T17:39:43-08:00
say $now->format; # => Wed, 27 May 2020 17:39:43 PDT
say $now->format('%H:%M:%S'); # => 17:39:43

# DESCRIPTION

This module lets you use [Mojo::Date](https://metacpan.org/pod/Mojo%3A%3ADate)'s concise date / time functionality within the context of your own time zone.
That's mainly useful when logging to the console with a custom [Mojo::Log](https://metacpan.org/pod/Mojo%3A%3ALog) format:

use Mojo::Log;
use MojoX::Date::Local;

my $logger = Mojo::Log->new;

$logger->format(
sub ($time, $level, @lines) {
my ($time, $level, @lines) = @_;
my $timestamp = MojoX::Date::Local->new($time)->to_datetime;
my $prefix = "[$timestamp] [$level]";
my $message = join "\n", @lines, "";
return "$prefix $message";
}
);

# METHODS

A MojoX::Date::Local provides [Mojo::Date](https://metacpan.org/pod/Mojo%3A%3ADate)'s methods, with a couple changes.

## to\_datetime

Render local date+time in [RFC 3339](http://tools.ietf.org/html/rfc3339) format, with timezone offset.
If the time has fractional seconds, those will be included in the output.

## format($fmt)

Return presumably locale-appropriate formatting of local date+time per [POSIX::strftime](https://metacpan.org/pod/POSIX%3A%3Astrftime)'s formatting rules.
`'%a, %d %b %Y %H:%M:%S %Z'` is used if `$fmt` string is not provided. This produces a string similar to but
not quite compliant with [RFC 7231](https://tools.ietf.org/html/rfc7231#section-7.1.1.1), which makes no
allowances for localization. But it's still nice to have when displaying dates informally.

# SEE ALSO

[Mojolicious](https://metacpan.org/pod/Mojolicious), [Mojo::Date](https://metacpan.org/pod/Mojo%3A%3ADate), [POSIX](https://metacpan.org/pod/POSIX)

# LICENSE

Copyright (C) Brian Wisti.

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.

# AUTHOR

Brian Wisti <[email protected]>