...
Eroare ASP.NET Core · Model binding, JSON, 400 și 415

Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to bind parameter "DateOnly de" from "31.12.2026".

Pe scurt

Datele din URL sunt convertite cu cultura invariantă, care nu înțelege formatul românesc zi.lună.an. Trimite datele în format ISO (2026-12-31) sau primește textul și convertește-l cu DateOnly.TryParseExact și formatul dd.MM.yyyy.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Pentru DateTime, DateOnly, DateTimeOffset și TimeOnly, Minimal APIs apelează TryParse cu CultureInfo.InvariantCulture. Cultura invariantă acceptă formatul ISO 8601 (2026-12-31, 2026-12-31T14:30:00) și formatul american 12/31/2026, dar nu și 31.12.2026 sau 31/12/2026. Rezultatul este 400 cu valoarea primită în mesaj.

Alegerea e deliberată: un server nu trebuie să interpreteze diferit 01/02/2026 în funcție de limba mașinii. De aceea recomandarea pentru API-uri este ISO 8601 peste tot (în URL și în JSON). Când formatul e impus de un client existent (un formular, un export), primești valoarea ca string și o convertești explicit cu TryParseExact, cu formatul și cultura specificate.

De ce apare: cauzele frecvente

1Format românesc în query

Greșit
C#
// GET /rezervari?de=31.12.2026
app.MapGet("/rezervari", (DateOnly de) => de);
Corect
C#
// GET /rezervari?de=2026-12-31
app.MapGet("/rezervari", (DateOnly de) => de);

ISO 8601 este formatul pe care îl înțelege binding-ul, indiferent de cultura serverului.

2Format impus de client

Greșit
C#
app.MapGet("/rezervari", (DateOnly de) => de);
Corect
C#
app.MapGet("/rezervari", (string de) =>
    DateOnly.TryParseExact(de, "dd.MM.yyyy", CultureInfo.InvariantCulture, DateTimeStyles.None, out var data)
        ? Results.Ok(data)
        : Results.BadRequest("Data trebuie să fie de forma zz.ll.aaaa"));

TryParseExact acceptă exact formatul dat, cu using System.Globalization;.

Repară tu

Repară eroarea, direct în pagină

Formularul de rezervări trimite data în formatul românesc: GET /rezervari?de=31.12.2026, iar API-ul răspunde 400: Failed to bind parameter "DateOnly de" from "31.12.2026".. Repară handler-ul ca formatul zz.ll.aaaa să fie acceptat, iar o dată invalidă să dea 400 cu Data trebuie să fie de forma zz.ll.aaaa.

Codul care dă eroarea
C#
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/rezervari", (DateOnly de) =>
    $"Rezervări începând cu {de.ToString("yyyy-MM-dd")}");

app.Run();
După reparație, programul afișează
GET /rezervari?de=31.12.2026 → 200 OK
Rezervări începând cu 2026-12-31
GET /rezervari?de=2026-31-12 → 400 Bad Request
"Data trebuie să fie de forma zz.ll.aaaa"
Indiciu

Primește data ca text și convertește-o cu un format exact, în cultura invariantă.

Alte forme ale mesajului

  • Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to bind parameter "DateTime de" from "31.12.2026".
  • Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to bind parameter "Nullable<DateOnly> pana" from "31/12/2026".

Cum o eviți pe viitor

  • Folosește ISO 8601 (yyyy-MM-dd) în toate API-urile, în URL și în JSON.
  • Formatează data pentru utilizator doar în interfață, nu în contractul API-ului.
  • Când trebuie să accepți alt format, convertește explicit cu TryParseExact și răspunde cu un mesaj clar la eroare.

Întrebări frecvente

De ce pe calculatorul meu, în română, tot nu merge?

Binding-ul nu folosește cultura sistemului, ci pe cea invariantă. Așa comportamentul e identic pe orice server.

DateOnly sau DateTime pentru o rezervare?

Pentru o zi fără oră, DateOnly (.NET 6+) e mai precis: nu ai probleme cu fusul orar sau cu ora 00:00. Pentru momente exacte, DateTimeOffset.

Erori înrudite

← Toate erorile ASP.NET Core

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață ASP.NET Core de la zero, cu exerciții la fiecare lecție

Curs ASP.NET Core: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 20 lecții sunt gratuite.