Skip to content

Document EFCore.PG 11.0 improvements and translations #476

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
roji wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Document EFCore.PG 11.0 improvements and translations #476

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
e7b1593
Document string ToString translation
roji Oct 20, 2026
2e26edc
Document EFCore.PG 11.0 improvements and translations
roji Oct 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions conceptual/EFCore.PG/mapping/nodatime.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -131,6 +131,7 @@ LocalDateTime.InZoneLeniently(DateTimeZoneProviders.Tzdb["Europe/Berlin"]).ToIns
ZonedDateTime.ToInstant | No PG operation (.NET-side conversion from ZonedDateTime to Instant only) |
Instant.InUtc | No PG operation (.NET-side conversion from Instant to ZonedDateTime only) |
Instant.ToDateTimeUtc | No PG operation (.NET-side conversion from Instant to UTC DateTime only) |
LocalDateTime.ToDateTimeUnspecified() | No PG operation (timestamp without time zone is unchanged) | Added in 11.0
EF.Functions.Sum(periods) | [sum(periods)](https://www.postgresql.org/docs/current/functions-aggregate.html#FUNCTIONS-AGGREGATE-TABLE) | See [Aggregate functions](translations.md#aggregate-functions).
EF.Functions.Sum(durations) | [sum(durations)](https://www.postgresql.org/docs/current/functions-aggregate.html#FUNCTIONS-AGGREGATE-TABLE) | See [Aggregate functions](translations.md#aggregate-functions).
EF.Functions.Average(periods) | [avg(durations)](https://www.postgresql.org/docs/current/functions-aggregate.html#FUNCTIONS-AGGREGATE-TABLE) | See [Aggregate functions](translations.md#aggregate-functions).
Expand Down
5 changes: 5 additions & 0 deletions conceptual/EFCore.PG/mapping/nts.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -162,6 +162,8 @@ EF.Functions.IsWithinDistance(geom1, geom2, d, useSpheriod) | [ST_DWithin(g
geom.IsSimple() | [ST_IsSimple(geom)](https://postgis.net/docs/ST_IsSimple.html)
geom.IsValid() | [ST_IsValid(geom)](https://postgis.net/docs/ST_IsValid.html)
lineString.Length | [ST_Length(lineString)](https://postgis.net/docs/ST_Length.html)
EF.Functions.LineInterpolatePoint(lineString, fraction) | [ST_LineInterpolatePoint(lineString, fraction)](https://postgis.net/docs/ST_LineInterpolatePoint.html) | Added in 11.0
EF.Functions.LineMerge(geom) | [ST_LineMerge(geom)](https://postgis.net/docs/ST_LineMerge.html) | Added in 11.0
geom.Normalized | [ST_Normalize(geom)](https://postgis.net/docs/ST_Normalize.html)
geomCollection.NumGeometries | [ST_NumGeometries(geomCollection)](https://postgis.net/docs/ST_NumGeometries.html)
polygon.NumInteriorRings | [ST_NumInteriorRings(polygon)](https://postgis.net/docs/ST_NumInteriorRings.html)
Expand All @@ -170,6 +172,9 @@ geom1.Overlaps(geom2) | [ST_Overlaps(
geom.PointOnSurface | [ST_PointOnSurface(geom)](https://postgis.net/docs/ST_PointOnSurface.html)
geom1.Relate(geom2) | [ST_Relate(geom1, geom2)](https://postgis.net/docs/ST_Relate.html)
geom.Reverse() | [ST_Reverse(geom)](https://postgis.net/docs/ST_Reverse.html)
EF.Functions.Scale(geom, xFactor, yFactor) | [ST_Scale(geom, xFactor, yFactor)](https://postgis.net/docs/ST_Scale.html) | Added in 11.0
EF.Functions.Scale(geom, xFactor, yFactor, zFactor) | [ST_Scale(geom, xFactor, yFactor, zFactor)](https://postgis.net/docs/ST_Scale.html) | Added in 11.0
EF.Functions.SetSrid(geom, srid) | [ST_SetSRID(geom, srid)](https://postgis.net/docs/ST_SetSRID.html) | Added in 11.0
geom1.SRID | [ST_SRID(geom1)](https://postgis.net/docs/ST_SRID.html)
lineString.StartPoint | [ST_StartPoint(lineString)](https://postgis.net/docs/ST_StartPoint.html)
geom1.SymmetricDifference(geom2) | [ST_SymDifference(geom1, geom2)](https://postgis.net/docs/ST_SymDifference.html)
Expand Down
31 changes: 31 additions & 0 deletions conceptual/EFCore.PG/mapping/translations.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,7 @@ stringValue.Replace(oldValue, newValue) | replace(stringVa
stringValue.StartsWith(value) | stringValue LIKE value \|\| '%' | char overload added in 11.0
stringValue.Substring(startIndex, length) | substr(stringValue, startIndex + 1, @length)
stringValue.ToLower() | lower(stringValue)
stringValue.ToString() | stringValue | Null values remain null
stringValue.ToUpper() | upper(stringValue)
stringValue.Trim() | btrim(stringValue)
stringValue.Trim(trimChar) | btrim(stringValue, trimChar)
Expand Down Expand Up @@ -71,6 +72,8 @@ EF.Functions.DateTrunc("month", value) | [date_trunc(
EF.Functions.DateTrunc("month", utcDateTime, "Europe/Berlin") | [date_trunc('month', utcDateTime, 'Europe/Berlin')](https://www.postgresql.org/docs/current/functions-datetime.html) | Added in 11.0; timestamp with time zone only
dateTime.AddDays(1) | [dateTime + INTERVAL '1 days'](https://www.postgresql.org/docs/current/functions-datetime.html#OPERATORS-DATETIME-TABLE) |
dateTime.AddHours(value) | [dateTime + INTERVAL '1 hours'](https://www.postgresql.org/docs/current/functions-datetime.html#OPERATORS-DATETIME-TABLE) |
dateTime.AddMilliseconds(value) (also DateTimeOffset) | [dateTime + value * INTERVAL '1 milliseconds'](https://www.postgresql.org/docs/current/functions-datetime.html#OPERATORS-DATETIME-TABLE) | Added in 11.0
dateTime.AddMicroseconds(value) (also DateTimeOffset) | [dateTime + value * INTERVAL '1 microseconds'](https://www.postgresql.org/docs/current/functions-datetime.html#OPERATORS-DATETIME-TABLE) | Added in 11.0
dateTime.AddMinutes(1) | [dateTime + INTERVAL '1 minutes'](https://www.postgresql.org/docs/current/functions-datetime.html#OPERATORS-DATETIME-TABLE) |
dateTime.AddMonths(1) | [dateTime + INTERVAL '1 months'](https://www.postgresql.org/docs/current/functions-datetime.html#OPERATORS-DATETIME-TABLE) |
dateTime.AddSeconds(1) | [dateTime + INTERVAL '1 seconds'](https://www.postgresql.org/docs/current/functions-datetime.html#OPERATORS-DATETIME-TABLE) |
Expand All @@ -80,6 +83,8 @@ dateTime.Day | [date_part('
dateTime.DayOfWeek | [floor(date_part('dow', dateTime))::INT](https://www.postgresql.org/docs/current/functions-datetime.html) |
dateTime.DayOfYear | [date_part('doy', dateTime)::INT](https://www.postgresql.org/docs/current/functions-datetime.html) |
dateTime.Hour | [date_part('hour', dateTime)::INT](https://www.postgresql.org/docs/current/functions-datetime.html) |
dateTime.Millisecond (also DateTimeOffset, TimeOnly) | [floor(date_part('milliseconds', dateTime))::INT % 1000](https://www.postgresql.org/docs/current/functions-datetime.html) | Added in 11.0
dateTime.Microsecond (also DateTimeOffset, TimeOnly) | [date_part('microseconds', dateTime)::INT % 1000](https://www.postgresql.org/docs/current/functions-datetime.html) | Added in 11.0
dateTime.Minute | [date_part('minute', dateTime)::INT](https://www.postgresql.org/docs/current/functions-datetime.html) |
dateTime.Month | [date_part('month', dateTime)::INT](https://www.postgresql.org/docs/current/functions-datetime.html) |
dateTime.Second | [date_part('second', dateTime)::INT](https://www.postgresql.org/docs/current/functions-datetime.html) |
Expand Down Expand Up @@ -129,6 +134,29 @@ EF.Functions.JsonExistAll(json, key1, key2) | json ?& ARRAY[key1, key2]
EF.Functions.JsonTypeof(json) | jsonb_typeof(json) or json_typeof(json) | Selected according to the mapped column type
EF.Functions.JsonPathExists(json, "$.Age") | JSON_EXISTS(json, '$.Age') | Added in 11.0; requires PostgreSQL 17 or above

## Hstore translations

The following operations are supported for `Dictionary<string, string>` and `ImmutableDictionary<string, string>` mapped to PostgreSQL [`hstore`](https://www.postgresql.org/docs/current/hstore.html). Operations shown with `immutableDictionary` apply only to `ImmutableDictionary<string, string>`.

| .NET | SQL | Notes |
| ---- | --- | ----- |
| dictionary[key] | dictionary -> key | Added in 11.0 |
| dictionary.GetValueOrDefault(key) | dictionary -> key | Added in 11.0 |
| dictionary.GetValueOrDefault(key, fallback) | CASE WHEN dictionary ? key THEN dictionary -> key ELSE fallback END | Added in 11.0 |
| dictionary.ContainsKey(key) | dictionary ? key | Added in 11.0 |
| dictionary.ContainsValue(value) | array_position(avals(dictionary), value) IS NOT NULL | Added in 11.0 |
| dictionary.Count | cardinality(akeys(dictionary)) | Added in 11.0 |
| immutableDictionary.IsEmpty | cardinality(akeys(immutableDictionary)) = 0 | Added in 11.0 |
| immutableDictionary.Remove(key) | immutableDictionary - key | Added in 11.0 |
| immutableDictionary.RemoveRange(keys) | immutableDictionary - keys | Added in 11.0 |
| immutableDictionary.SetItems(otherDictionary) | immutableDictionary \|\| otherDictionary | Added in 11.0 |
| keys.All(key => dictionary.ContainsKey(key)) | dictionary ?& keys | Added in 11.0 |
| keys.Any(key => dictionary.ContainsKey(key)) | dictionary ?\| keys | Added in 11.0 |

Lookups return SQL `NULL` for missing keys, stored NULL values and NULL hstores, rather than throwing for a missing key. The explicit `GetValueOrDefault` fallback distinguishes a missing key from a key whose stored value is NULL. Key existence and counts include stored-NULL entries, and `ContainsValue(null)` finds stored NULL values.

`SetItems` accepts another hstore-mapped mutable or immutable dictionary, not arbitrary sequences of key/value pairs.

## Miscellaneous functions

.NET | SQL | Notes
Expand All @@ -155,8 +183,11 @@ decimal.Parse(stringValue) | CAST(stringValue AS numeric) | Added
bytes[i] | get_byte(bytes, i) |
bytes.Contains(value) | position(value IN bytes) > 0 |
bytes.Any() | length(bytes) > 0 | Added in 11.0
bytes.Concat(bytes2) | bytes \|\| bytes2 | Added in 11.0
bytes.Length | length(@bytes) |
bytes1.SequenceEqual(bytes2) | @bytes = @second |
bitArray.Get(index) | get_bit(bitArray, index) = 1 | Added in 11.0
bitArray[index] | get_bit(bitArray, index) = 1 | Added in 11.0

## Math functions

Expand Down
Loading
Loading