pxt-calliope/docs/reference/pins/pulse-duration.md

# pulse Duration

Get the duration of the last pulse in microseconds.

```sig
pins.pulseDuration();
```

A pin pulse is detected in the [onPulsed](/reference/pins/on-pulsed) event. You use **pulseDuration** inside that event to get the duration of the pulse that triggered the event.

### ~ hint

**Simulator**: This function needs real hardware to work with. It's not supported in the simulator.

### ~

## Returns

* a [number](/types/number) that is the duration of the last pulse, measured in microseconds.

## Example

Wait for pin ``P0`` to be pulsed high. Display the duration of the pulse in microseconds on the LED screen.

```blocks
pins.onPulsed(DigitalPin.P0, PulseValue.High, () => {
    basic.showNumber(pins.pulseDuration());
});
```

## See also

[servo set pulse](/reference/pins/servo-set-pulse),
[on pulsed](/reference/pins/on-pulsed),
[digital read pin](/reference/pins/digital-read-pin)