Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to bind parameter "DateOnly de" from "31.12.2026".
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
// GET /rezervari?de=31.12.2026
app.MapGet("/rezervari", (DateOnly de) => de);// 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
app.MapGet("/rezervari", (DateOnly de) => de);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ă 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.
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();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ă.
Reparația
using System.Globalization;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/rezervari", (string de) =>
{
if (!DateOnly.TryParseExact(de, "dd.MM.yyyy", CultureInfo.InvariantCulture, DateTimeStyles.None, out var data))
return Results.BadRequest("Data trebuie să fie de forma zz.ll.aaaa");
return Results.Text($"Rezervări începând cu {data.ToString("yyyy-MM-dd")}");
});
app.Run();De ce merge
Binding-ul automat citea data cu cultura invariantă, care nu cunoaște formatul 31.12.2026. Primind un string, convertești tu cu DateOnly.TryParseExact(de, "dd.MM.yyyy", CultureInfo.InvariantCulture, DateTimeStyles.None, out var data). Răspunsul afișează data în format ISO cu ToString("yyyy-MM-dd"), iar textele care nu respectă formatul primesc 400 cu mesajul cerut.
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
Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to bind parameter "int pretMax" from "99.90". Valoarea primită în query, rută sau antet nu poate fi convertită în tipul parametrului (de exemplu 99.90 în int, abc în int). Alege tipul potrivit datelor (decimal pentru prețuri) sau o constrângere de rută, iar pentru intrări greșite răspunsul 400 e corect. Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to bind parameter "Stare stare" from "deschisa". Minimal APIs convertește enum-urile din query și rută cu Enum.TryParse sensibil la majuscule, deci deschisa nu se potrivește cu Deschisa și răspunsul e 400. Primește valoarea ca string și folosește Enum.TryParse(valoare, ignoreCase: true, out ...). System.Text.Json.JsonException: The JSON value could not be converted to Stare. Path: $.stare | LineNumber: 0 | BytePositionInLine: 35. System.Text.Json nu poate pune valoarea din JSON în tipul proprietății: cel mai des un enum trimis ca text ("Livrata") fără JsonStringEnumConverter, sau un text într-un număr. Adaugă convertorul pentru enum-uri sau corectează tipul. Path arată câmpul. Î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.
