---
name: "IO::Async::Timer::Absolute"
section: "3pm"
platform: "linux"
package: "libio-async-perl"
version: "0.804-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/IO::Async::Timer::Absolute"
---

# IO::Async::Timer::Absolute(3pm)

event callback at a fixed future time

## NAME

"IO::Async::Timer::Absolute" - event callback at a fixed future time

## SYNOPSIS

```
   use IO::Async::Timer::Absolute;
   use POSIX qw( mktime );
   use IO::Async::Loop;
   my $loop = IO::Async::Loop->new;
   my @time = gmtime;
   my $timer = IO::Async::Timer::Absolute->new(
      time => mktime( 0, 0, 0, $time[3]+1, $time[4], $time[5] ),
      on_expire => sub {
         print "It's midnight\n";
         $loop->stop;
      },
   );
   $loop->add( $timer );
   $loop->run;
```

## DESCRIPTION

This subclass of IO::Async::Timer implements one-shot events at a fixed time in the future. The object waits for a given timestamp, and invokes its callback at that point in the future.

For a `"Timer"` object that waits for a delay relative to the time it is started, see instead IO::Async::Timer::Countdown.

## EVENTS

The following events are invoked, either using subclass methods or CODE references in parameters:

### on\_expire

Invoked when the timer expires.

## PARAMETERS

The following named parameters may be passed to `"new"` or `"configure"`:

### on\_expire =\> CODE

CODE reference for the `"on_expire"` event.

### time =\> NUM

The epoch time at which the timer will expire.

Once constructed, the timer object will need to be added to the `"Loop"` before it will work.

Unlike other timers, it does not make sense to `"start"` this object, because its expiry time is absolute, and not relative to the time it is started.

## AUTHOR

Paul Evans \<leonerd@leonerd.org.uk\>