---
id: post/aardvarklabs-blog/1696
type: post
title: Understanding ToText() in Business Central 2025
summary: ToText(), new in Business Central 2025 Wave 1, turns values of many AL data types into text using a fixed default format with no formatting options, though date and time types take an optional boolean for invariant output. The post shows the results for decimal, big integer, integer, byte, boolean, date, time, datetime, duration, GUID and version, noting output mostly matches Format(value, 0, 0) and that it does not replace Format.
tier: community
language: en
tags:
  - totext method
  - data type conversion
  - text formatting
  - al programming
  - business central 2025
system: development
review:
  state: reviewed
  by: opus
  at: "2026-10-08T02:01:14.577Z"
  flags: []
generated:
  at: "2026-10-08T01:26:53.141Z"
  pipeline: 0.2.0
  prompts:
    extract-post: 1
  input_hash: ae794ddf4d453f272929afdce00c7c8534911b560f4c2f2b20086ed0dd2569ac
evidence:
  - kind: blog
    url: https://aardvarklabs.blog/2025/04/25/understanding-totext-in-business-central-2025/
    title: Understanding ToText() in Business Central 2025
    date: "2025-04-25"
    commit: null
    t: null
    quote: null
  - kind: blog
    url: https://aardvarklabs.blog/2025/04/25/understanding-totext-in-business-central-2025/
    title: Understanding ToText() in Business Central 2025
    date: "2025-04-25"
    commit: null
    t: null
    quote: This is not a replacement for the Format method but provides a quick way to format a value for display.
  - kind: blog
    url: https://aardvarklabs.blog/2025/04/25/understanding-totext-in-business-central-2025/
    title: Understanding ToText() in Business Central 2025
    date: "2025-04-25"
    commit: null
    t: null
    quote: The ToText() will function across the full precision of the value.
links:
  learn: []
  objects: []
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
post_id: "1696"
source_id: aardvarklabs-blog
source_name: Aardvark Labs
url: https://aardvarklabs.blog/2025/04/25/understanding-totext-in-business-central-2025/
published_at: "2025-04-25T12:00:00.000Z"
author: Marcel Chabot
full_text: false
words: 1095
quotes:
  - text: This is not a replacement for the Format method but provides a quick way to format a value for display.
    why_it_matters: Establishes the purpose and scope of ToText() as a convenience method rather than a full replacement for existing formatting approaches
  - text: The ToText() will function across the full precision of the value.
    why_it_matters: Highlights a key difference from default field display, showing ToText() preserves decimal precision rather than truncating it
code_objects_mentioned:
  - page ARD_ToTextExample
systems:
  - development
versions_mentioned:
  - 2025 Wave 1
preview:
  embeddable: true
  frame_url: https://aardvarklabs.blog/2025/04/25/understanding-totext-in-business-central-2025/embed/
  image: https://aardvarklabs.blog/wp-content/uploads/2025/04/463f24e5-3951-450b-928d-d45f079decee.jpg
  image_alt: null
  image_w: 1024
  image_h: 1024
  site_name: Aardvark Labs
  favicon: https://aardvarklabs.blog/wp-content/uploads/2024/04/design-1.png?w=32
  probed_at: "2026-10-07T11:52:10.608Z"
---

# Understanding ToText() in Business Central 2025

[Read the post](https://aardvarklabs.blog/2025/04/25/understanding-totext-in-business-central-2025/) · Aardvark Labs (Marcel Chabot) · 2025-04-25 · 1095 words · tier community · reviewed (checked by Opus)

> ToText(), new in Business Central 2025 Wave 1, turns values of many AL data types into text using a fixed default format with no formatting options, though date and time types take an optional boolean for invariant output. The post shows the results for decimal, big integer, integer, byte, boolean, date, time, datetime, duration, GUID and version, noting output mostly matches Format(value, 0, 0) and that it does not replace Format.

## Key points

- ToText() is a quick display helper added in BC 2025 Wave 1 and is not a replacement for the Format method
- Date, time, datetime and duration ToText() accept a boolean; the default is false, and true gives invariant output like Format(value, 0, 9)
- Decimal ToText() keeps the full precision of the value, while a default Decimal field shows two decimals
- Byte ToText() returns the integer value rather than the ASCII character, GUIDs lose their braces, and dates use two-digit month, day and year
- A sample card page ARD_ToTextExample shows each type next to its ToText() result

## Quotes

- "This is not a replacement for the Format method but provides a quick way to format a value for display." (Establishes the purpose and scope of ToText() as a convenience method rather than a full replacement for existing formatting approaches)
- "The ToText() will function across the full precision of the value." (Highlights a key difference from default field display, showing ToText() preserves decimal precision rather than truncating it)

## AL objects mentioned

As named in the post. A name that matches one object page by exact type and name links to it; the others stay as named.

- page "ARD_ToTextExample"

Not found in BC28-30: page "ARD_ToTextExample".

## Context

- Features: ToText() method, decimal formatting, date formatting, time formatting, GUID formatting, boolean conversion, data type conversion
- Versions: 2025 Wave 1

Source: Aardvark Labs, community blog. Summary, key points and quotes are derived (CONTENT-NOTICE.md); read the original for the full text.