Funktionerna Replace och Substitute

Gäller to: Arbetsyteappar Dataverse formula columns Datorflöden Modellbaserade appar Power Platform CLI

Ersätt en del av en textsträng med en annan sträng.

Beskrivning

Funktionen Replace identifierar den text som ska ersättas genom att starta position och längd.

Funktionen Substitute identifierar texten som ska ersättas genom att matcha en sträng. Om fler än en matchning hittas kan du ersätta alla eller ange en som ska ersättas.

Om du skickar en enkel sträng är returvärdet den ändrade strängen. Om du överför en tabell med en enda kolumn som innehåller strängar, är det returnerade värdet en tabell med en Värde-kolumn med ändrade strängar. Om du har en tabell med flera kolumner kan du omforma den till en tabell med en kolumn, så som beskrivs i Arbeta med tabeller.

Syntax

Replace( String, StartingPosition, NumberOfCharacters, NewString )

  • String – Krävs. Strängen som ska användas.
  • StartingPosition – obligatoriskt. Teckenposition för att starta ersättningen. Det första tecknet i String är vid position 1.
  • NumberOfCharacters – Krävs. Antalet tecken som ska ersättas i String.
  • NewString – Krävs. Ersättningssträngen. Antalet tecken i det här argumentet kan skilja sig från argumentet NumberOfCharacters.

Substitute( String, OldString, NewString [, InstanceNumber ] )

  • String – Krävs. Strängen som ska användas.
  • OldString – obligatoriskt. Strängen som ska ersättas.
  • NewString – Krävs. Ersättningssträngen. OldString och NewString kan ha olika längd.
  • InstanceNumber – valfritt. Använd det här argumentet om du vill ange vilken instans av OldString som ska ersättas om String innehåller fler än en instans. Om du inte anger det här argumentet kommer alla förekomster att ersättas.

Replace( SingleColumnTable, StartingPosition, NumberOfCharacters, NewString )

  • SingleColumnTable – krävs. En tabell med en kolumn med strängar som ska behandlas.
  • StartingPosition – obligatoriskt. Teckenposition för att starta ersättningen. Det första tecknet i varje sträng i tabellen är vid position 1.
  • NumberOfCharacters – Krävs. Antalet tecken som ska ersättas i varje sträng.
  • NewString – Krävs. Ersättningssträngen. Antalet tecken i det här argumentet kan skilja sig från argumentet NumberOfCharacters.

Substitute( SingleColumnTable, OldString, NewString [, InstanceNumber ] )

  • SingleColumnTable – krävs. En tabell med en kolumn med strängar som ska behandlas.
  • OldString – obligatoriskt. Strängen som ska ersättas.
  • NewString – Krävs. Ersättningssträngen. OldString och NewString kan ha olika längd.
  • InstanceNumber – valfritt. Använd det här argumentet om du vill ange vilken instans av OldString som ska ersättas om String innehåller fler än en instans. Om du inte anger det här argumentet kommer alla förekomster att ersättas.

Exempel

Formel Beskrivning Resultat
Replace( "abcdefghijk", 6, 5, "*" ) Ersätter fem tecken i "abcdefghijk" med ett enda "*"-tecken från och med det sjätte tecknet ("f"). "abcde*k"
Replace( "2019", 3, 2, "20" ) Ersätter de två sista tecknen i "2019" med "20". "2020"
Replace( "123456", 1, 3, "_" ) Ersätter de första tre tecknen i "123456" med ett enda "_"-tecken. "_456"
Substitute( "Sales Data", "Sales", "Cost" ) Ersätter strängen "kostnad" för "försäljning". "Kostnadsdata"
Substitute( "Quarter 1, 2018", "1", "2", 1 ) Ersätter endast den första förekomsten av "1" med "2", eftersom det fjärde argumentet (InstanceNumber) medföljer 1. "Quarter 2, 2018"
Substitute( "Quarter 1, 2011", "1", "2", 3 ) Ersätter endast den tredje förekomsten av "1" med "2", eftersom det fjärde argumentet (InstanceNumber) medföljer 3. "Quarter 1, 2012"
Substitute( "Quarter 1, 2011", "1", "2" ) Ersätter alla instanser av "1" med "2", eftersom det fjärde argumentet (InstanceNumber) inte medföljer. "Quarter 2, 2022"
Replace(
[ "Quarter 1, 2018",
"Quarter 2, 2011",
"Quarter 4, 2019" ],
9, 1, "3" )
Ersätter det nionde tecknet i varje post i tabellen med en kolumn med "3". En tabell med en kolumn med Value-kolumn innehåller följande värden: [ "Quarter 3, 2018",
"Quarter 3, 2011",
"Quarter 3, 2019" ]
Substitute(
[ "Qtr 1, 2018",
"Quarter 1, 2011",
"Q1, 2019" ],
"1", "3", 1 )
Eftersom det fjärde argumentet ( InstanceNumber) tillhandahålls med värdet 1 ersätter endast den första förekomsten av "1" i varje post i tabellen med en kolumn med "3". En tabell med en kolumn med Value-kolumn innehåller följande värden: [ "Qtr 3, 2018",
"Quarter 3, 2011",
"Q3,2019"]
Substitute(
[ "Qtr 1, 2018",
"Quarter 1, 2011",
"Q1, 2019" ],
"1", "3" )
Eftersom det fjärde argumentet ( InstanceNumber) inte tillhandahålls alla instanser för "1" i varje post i tabellen med en kolumn med "3". En tabell med en kolumn med Value-kolumn innehåller följande värden: [ "Qtr 3, 2038",
"Quarter 3, 2033",
"Q3,2039"]