---
title: "DatedValues – API-Referenz · Quittio"
description: "Values that change on dates, e.g. tax rates or reference interest rates: every value holds from its date until the next change."
canonical_url: "https://quittio.dev/docs/api/Quittio/Core/Support/DatedValues"
locale: de
meta:
  "og:description": "Values that change on dates, e.g. tax rates or reference interest rates: every value holds from its date until the next change."
  "og:image": "https://quittio.dev/og/quittio-de.jpg"
  "og:image:alt": "Quittio: E-Rechnungen für PHP und Laravel. Rechtssicher, validiert, archiviert, mit geprüfter Beispielrechnung."
  "og:image:height": "630"
  "og:image:type": image/jpeg
  "og:image:width": "1200"
  "og:title": "DatedValues – API-Referenz · Quittio"
  "twitter:image": "https://quittio.dev/og/quittio-de.jpg"
  "twitter:image:alt": "Quittio: E-Rechnungen für PHP und Laravel. Rechtssicher, validiert, archiviert, mit geprüfter Beispielrechnung."
---

> Index of every page on this site: [llms.txt](https://quittio.dev/llms.txt)

[API reference](https://quittio.dev/docs/api) / [Quittio](https://quittio.dev/docs/api/Quittio) \\ [Core](https://quittio.dev/docs/api/Quittio/Core) \\ [Support](https://quittio.dev/docs/api/Quittio/Core/Support)

# DatedValues

final readonly class in quittio/core

`Quittio\Core\Support\DatedValues` · [Source](https://github.com/Quittio/quittio/blob/v0.7.1/packages/core/src/Support/DatedValues.php#L13)

Values that change on dates, e.g. tax rates or reference interest rates: every value holds from its date until the next change.

## Methods \#

| Method | Description |
| --- | --- |
| `->__construct()` | |
| `->changes()` | Every change: ISO date => value, sorted by date. |
| `->lastChange()` | Date of the last change; null without values. |
| `->on()` | The value that holds on the date; null before the first change. |
| `->periods()` | The periods of constant value between two dates (both included), in order; days before the first change are left out. |
| `->withValue()` | A copy with a value that holds from $from on; an existing value of that date is replaced. |

### `__construct()`#

```
public function __construct(array<string, string> $values)
```

| Parameter | Type | Description |
| --- | --- | --- |
| `$values` | `array<string, string>` | ISO date (YYYY-MM-DD) => value from that date on |

<dl><dt>Throws</dt>
<dd><code><a href="https://quittio.dev/docs/api/Quittio/Core/Exceptions/InvalidArgumentException">InvalidArgumentException</a></code> – for a key that is no ISO date</dd></dl>

### `changes()`#

```
public function changes(): array<string, string>
```

Every change: ISO date => value, sorted by date.

<dl><dt>Returns</dt>
<dd><code>array&lt;string, string&gt;</code></dd>
</dl>

### `lastChange()`#

```
public function lastChange(): ?Date
```

Date of the last change; null without values.

<dl><dt>Returns</dt>
<dd><code>?<a href="https://quittio.dev/docs/api/Quittio/Core/Support/Date">Date</a></code></dd>
</dl>

### `on()`#

```
public function on(Date $date): ?string
```

The value that holds on the date; null before the first change.

| Parameter | Type | Description |
| --- | --- | --- |
| `$date` | `[Date](https://quittio.dev/docs/api/Quittio/Core/Support/Date)` | |

<dl><dt>Returns</dt>
<dd><code>?string</code></dd>
</dl>

### `periods()`#

```
public function periods(
    Date $from,
    Date $until,
): list<array{from: Date, until: Date, value: string}>
```

The periods of constant value between two dates (both included), in order; days before the first change are left out.

| Parameter | Type | Description |
| --- | --- | --- |
| `$from` | `[Date](https://quittio.dev/docs/api/Quittio/Core/Support/Date)` | |
| `$until` | `[Date](https://quittio.dev/docs/api/Quittio/Core/Support/Date)` | |

<dl><dt>Returns</dt>
<dd><code>list&lt;array{from: <a href="https://quittio.dev/docs/api/Quittio/Core/Support/Date">Date</a>, until: <a href="https://quittio.dev/docs/api/Quittio/Core/Support/Date">Date</a>, value: string}&gt;</code></dd>
</dl>

### `withValue()`#

```
public function withValue(Date|string $from, string $value): self
```

A copy with a value that holds from $from on; an existing value of that date is replaced.

| Parameter | Type | Description |
| --- | --- | --- |
| `$from` | `[Date](https://quittio.dev/docs/api/Quittio/Core/Support/Date)\|string` | |
| `$value` | `string` | |

<dl><dt>Returns</dt>
<dd><code>self</code></dd>
</dl>

```json
{"@context":"https://schema.org","@graph":[{"@id":"https://quittio.dev/#website","@type":"WebSite","description":"E-Rechnungen für PHP und Laravel: ZUGFeRD, XRechnung und Peppol erstellen, prüfen, lesen und archivieren.","inLanguage":"de-DE","name":"Quittio","url":"https://quittio.dev/","publisher":{"@id":"https://quittio.dev/#identity"},"workTranslation":{"@id":"https://quittio.dev/en#website"}},{"@id":"https://quittio.dev/docs/api/Quittio/Core/Support/DatedValues#webpage","@type":"WebPage","description":"Values that change on dates, e.g. tax rates or reference interest rates: every value holds from its date until the next change.","name":"DatedValues – API-Referenz","url":"https://quittio.dev/docs/api/Quittio/Core/Support/DatedValues","isPartOf":{"@id":"https://quittio.dev/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://quittio.dev/docs/api/Quittio/Core/Support/DatedValues"]}],"primaryImageOfPage":{"@id":"https://quittio.dev/#logo"}},{"@id":"https://quittio.dev/#identity","@type":"Organization","description":"Open-Source-Bibliothek für E-Rechnungen in PHP und Laravel (ZUGFeRD, XRechnung, Peppol) und Quittio Managed.","email":"kontakt@niklasforst.de","legalName":"Niklas Forst – Softwareentwicklung","name":"Quittio","url":"https://quittio.dev","founder":{"@type":"Person","name":"Niklas Forst","url":"https://quittio.dev/ueber"},"logo":{"@id":"https://quittio.dev/#logo"},"sameAs":["https://github.com/Quittio/quittio","https://packagist.org/packages/quittio/quittio"]},{"@id":"https://quittio.dev/#logo","@type":"ImageObject","caption":"Quittio","contentUrl":"https://quittio.dev/logo.png","inLanguage":"de-DE","url":"https://quittio.dev/logo.png"}]}
```