Skip to content

US-488186: Content Update - Localization fix: <dotnet-docs> - data types should not be translated #48439

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

Merged
merged 1 commit into from
Sep 10, 2025
+33 −32
Merged

US-488186: Content Update - Localization fix: <dotnet-docs> - data types should not be translated #48439

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
65 changes: 33 additions & 32 deletions docs/standard/data/sqlite/types.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,48 +2,49 @@
title: Data types
ms.date: 12/13/2019
description: Describes the supported data types and some of the limitations around them.
no-loc: ["INTEGER", "BLOB", "TEXT", "REAL"]
---
# Data types

SQLite only has four primitive data types: INTEGER, REAL, TEXT, and BLOB. APIs that return database values as an `object` will only ever return one of these four types. Additional .NET types are supported by Microsoft.Data.Sqlite, but values are ultimately coerced between these types and one of the four primitive types.

| .NET | SQLite | Remarks |
| -------------- | ------- | ------------------------------------------------------------- |
| Boolean | INTEGER | `0` or `1` |
| Byte | INTEGER | |
| Byte[] | BLOB | |
| Char | TEXT | UTF-8 |
| DateOnly | TEXT | yyyy-MM-dd |
| DateTime | TEXT | yyyy-MM-dd HH:mm:ss.FFFFFFF |
| DateTimeOffset | TEXT | yyyy-MM-dd HH:mm:ss.FFFFFFFzzz |
| Decimal | TEXT | `0.0###########################` format. REAL would be lossy. |
| Double | REAL | |
| Guid | TEXT | 00000000-0000-0000-0000-000000000000 |
| Int16 | INTEGER | |
| Int32 | INTEGER | |
| Int64 | INTEGER | |
| SByte | INTEGER | |
| Single | REAL | |
| String | TEXT | UTF-8 |
| TimeOnly | TEXT | HH:mm:ss.fffffff |
| TimeSpan | TEXT | d.hh:mm:ss.fffffff |
| UInt16 | INTEGER | |
| UInt32 | INTEGER | |
| UInt64 | INTEGER | Large values overflow |
| .NET | SQLite | Remarks |
| -------------- | ------- | ----------------------------------------------------------------------------------|
| :::no-loc text="Boolean"::: | INTEGER | `0` or `1` |
| :::no-loc text="Byte"::: | INTEGER | |
| :::no-loc text="Byte[] "::: | BLOB | |
| :::no-loc text="Char"::: | TEXT | UTF-8 |
| :::no-loc text="DateOnly"::: | TEXT | :::no-loc text="yyyy-MM-dd"::: |
| :::no-loc text="DateTime"::: | TEXT | :::no-loc text="yyyy-MM-dd HH:mm:ss.FFFFFFF"::: |
| :::no-loc text="DateTimeOffset"::: | TEXT | :::no-loc text="yyyy-MM-dd HH:mm:ss.FFFFFFFzzz"::: |
| :::no-loc text="Decimal"::: | TEXT | `0.0###########################` format. REAL would be lossy. |
| :::no-loc text="Double"::: | REAL | |
| :::no-loc text="Guid"::: | TEXT | 00000000-0000-0000-0000-000000000000 |
| :::no-loc text="Int16"::: | INTEGER | |
| :::no-loc text="Int32"::: | INTEGER | |
| :::no-loc text="Int64"::: | INTEGER | |
| :::no-loc text="SByte"::: | INTEGER | |
| :::no-loc text="Single"::: | REAL | |
| :::no-loc text="String"::: | TEXT | UTF-8 |
| :::no-loc text="TimeOnly"::: | TEXT | HH:mm:ss.fffffff |
| :::no-loc text="TimeSpan"::: | TEXT | d.hh:mm:ss.fffffff |
| :::no-loc text="UInt16"::: | INTEGER | |
| :::no-loc text="UInt32"::: | INTEGER | |
| :::no-loc text="UInt64"::: | INTEGER | Large values overflow |

## Alternative types

Some .NET types can be read from alternative SQLite types. Parameters can also be configured to use these alternative types. For more information, see [Parameters](parameters.md#alternative-types).

| .NET | SQLite | Remarks |
| -------------- | ------- | ---------------- |
| Char | INTEGER | UTF-16 |
| DateOnly | REAL | Julian day value |
| DateTime | REAL | Julian day value |
| DateTimeOffset | REAL | Julian day value |
| Guid | BLOB | |
| TimeOnly | REAL | In days |
| TimeSpan | REAL | In days |
| .NET | SQLite | Remarks |
| -------------- | ------- | ------------------------------------ |
| :::no-loc text="Char"::: | INTEGER | UTF-16 |
| :::no-loc text="DateOnly"::: | REAL | Julian day value |
| :::no-loc text="DateTime"::: | REAL | Julian day value |
| :::no-loc text="DateTimeOffset"::: | REAL | Julian day value |
| :::no-loc text="Guid"::: | BLOB | |
| :::no-loc text="TimeOnly"::: | REAL | In days |
| :::no-loc text="TimeSpan"::: | REAL | In days |

For example, the following query reads a TimeSpan value from a REAL column in the result set.

Expand Down
Loading